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The OLE Property Set Data Structures are a generic persistence format for sets of properties 

typically used to associate simple typed metadata with a file. 

Intellectual Property Rights Notice for Open Specifications Documentation 

■ Technical Documentation. Microsoft publishes Open Specifications documentation for 
protocols, file formats, languages, standards as well as overviews of the interaction among each 
of these technologies. 

■ Copyrights. This documentation is covered by Microsoft copyrights. Regardless of any other 
terms that are contained in the terms of use for the Microsoft website that hosts this 
documentation, you may make copies of it in order to develop implementations of the 
technologies described in the Open Specifications and may distribute portions of it in your 
implementations using these technologies or your documentation as necessary to properly 
document the implementation. You may also distribute in your implementation, with or without 
modification, any schema, IDL's, or code samples that are included in the documentation. This 
permission also applies to any documents that are referenced in the Open Specifications. 

■ No Trade Secrets. Microsoft does not claim any trade secret rights in this documentation. 

■ Patents. Microsoft has patents that may cover your implementations of the technologies 
described in the Open Specifications. Neither this notice nor Microsoft's delivery of the 
documentation grants any licenses under those or any other Microsoft patents. However, a given 
Open Specification may be covered by Microsoft Open Specification Promise or the Community 
Promise . If you would prefer a written license, or if the technologies described in the Open 
Specifications are not covered by the Open Specifications Promise or Community Promise, as 
applicable, patent licenses are available by contacting iplq@microsoft.com . 

■ Trademarks. The names of companies and products contained in this documentation may be 
covered by trademarks or similar intellectual property rights. This notice does not grant any 
licenses under those rights. 

■ Fictitious Names. The example companies, organizations, products, domain names, e-mail 
addresses, logos, people, places, and events depicted in this documentation are fictitious. No 
association with any real company, organization, product, domain name, email address, logo, 
person, place, or event is intended or should be inferred. 

servation of Rights. All other rights are reserved, and this notice does not grant any rights 
specifically described above, whether by implication, estoppel, or otherwise. 

e Open Specifications do not require the use of Microsoft programming tools or 
rogramifijpg environments in order for you to develop an implementation. If you have access to 
licrosoft programming tools and environments you are free to take advantage of them. Certain 
'pen Specifications are intended for use in conjunction with publicly available standard 



[MS-OLEPS] - V20111214 

Object Unking and Embedding (OLE) Property Set Data Structures 


Copyright © 2011 Microsoft Corporation. 
Release: Wednesday, December 14, 2011 


specifications and network programming art, and assumes that the reader either is familiar with the 
aforementioned material or has immediate access to it. 


Revision Summary 


Date 

Revision 

History 

Revision 

Class 

Comments 

07/16/2010 

1.0 

New 

First Release. 

08/27/2010 

1.0 

No change 

No changes to the meaning, language, or formatting of 
the technical content. 

10/08/2010 

1.0 

No change 

No changes to the meaning, language, or formatting of 
the technical content. 

11/19/2010 

1.0 

No change 

No changes to the meaning, language, or formatting of 
the technical content. 

01/07/2011 

1.0 

No change 

No changes to the meaning, language, or formatting of 
the technical content. 

02/11/2011 

1.0 

No change 

No changes to the meaning, language, or formatting of 
the technical content. 

03/25/2011 

1.0 

No change 

No changes to the meaning, language, or formatting of 
^the technical content. 

05/06/2011 

1.0 

No change 

No changes to the meaning, language, or formatting of 
,tfie tech n i caropnte n t . 

06/17/2011 

1.1 

Minor 

Clarified the meaning of the technical content. 

09/23/2011 

1.1 

No change 

No changes to the meaning, language, or formatting of 
the technical content. 

12/16/2011 

2.0 

Major 

Significantly changed the technical content. 



2/64 


[MS-OLEPS] - V20111214 

Object Unking and Embedding (OLE) Property Set Data Structures 
Copyright © 2011 Microsoft Corporation. 

Release: Wednesday, December 14, 2011 




Contents 


1 Introduction 

1.1 Glossary 

1.2 References 

1.2.1 Normative References 

1.2.2 Informative References 

1.3 Overview 

1.3.1 Background 

1.3.2 Properties and Property Sets 

1.4 Relationship to Protocols and Other Structures 

1.5 Applicability Statement 

1.6 Versioning and Localization 

1.7 Vendor-Extensible Fields 


2.21 

2.22 

Is 

i 

2.24 

2.24 


2 Structures 

2.1 Propertyldentifier 

2.2 PropertyType 

2.3 CURRENCY (Packet Version) 

2.4 DATE (Packet Version) 

2.5 CodePageString 

2.6 DECIMAL (Packet Version) 

2.7 UnicodeString 

2.8 FILETIME (Packet Version) 

2.9 BLOB 

2.10 IndirectPropertyName 

2.11 ClipboardData 

2.12 GUID (Packet Version) 

2.13 VersionedStream 

2.14 Vector and Array Property Types 

2.14.1 Property Types in Variable-Typed Vectors and Arrays. 

2.14.2 VectorHeader 

2.14.3 ArrayDimension 

2.14.4 ArrayHeader 

2.15 TypedPropertyValue 

2.16 DictionaryEntry 

2.17 Dictionary 

2.18 Special Properties 

2.18.1 Dictionary Property 

2.18.2 CodePage Property 

2.18.3 Locale Property 

2.18.4 Behavior Property 

2.19 PropertyldentifierAndOffset 

jP’zlP^lropertySet 

PropertySetStream 

£.22. Non-Simple Property Set Storage Format 

2.23 Property Set Stream and Storage Names 

2.24 Standard Bindings 

2.24.1 Compound File Binding 

2.24.2 Alternate Stream Binding 

2.24.3 Control Stream 

2.24.4 Simple Property Set Stream 


[MS-OLEPS] - V20111214 

Object Unking and Embedding (OLE) Property Set Data Structures 
Copyright © 2011 Microsoft Corporation. 

Release: Wednesday, December 14, 2011 


5 

5 

6 
6 
6 


..8 

..8 

,.8 

..8 

..9 

10 

10 

10 

15 

15 

15 

16 
16 
17 
17 

17 

18 
18 
19 
19 

19 

20 
21 
21 
22 
26 
26 
27 
27 

27 

28 
28 
28 
28 
29 
32 
32 
34 
34 
34 

34 

35 


3/64 



2.24.5 Non-Simple Property Set Storage 

2.25 Well-Known Property Set Formats 

2.25.1 Summarylnformation 

2.25.2 PropertyBag 

3 Structure Examples 

3.1 Summarylnformation Property Set 

3.1.1 CodePage 

3.1.2 PIDSI_TITLE 

3.1.3 PIDSI_SUBJECT 

3.1.4 PIDSI_AUTHOR 

3.1.5 PIDSI_KEYWORDS 

3.1.6 PIDSI_COMMENTS 

3.1.7 PIDSI_TEM PLATE 

3.1.8 PI DSI_LAST AUTH 0 R 

3.1.9 PIDSI_REVN UMBER 

3.1.10 PIDSI_APPNAME 

3.1.11 PIDSI_EDITTIME 

3.1.12 PIDSI_LASTPRINTED 

3.1.13 PIDSI_CREATE_DTM 

3.1.14 PIDSI_LASTSAVE_DTM 

3.1.15 PIDSI_PAGECOUNT 

3.1.16 PIDSI_WORDCOUNT 

3.1.17 PIDSI_CHARCOUNT 

3.1.18 PIDSI_DOC_SECURITY 

3.2 PropertyBag Property Set 

3.2.1 Control Stream ("{4c8ccl55-6cle-lldl-8e41-00c04fb9386d}") 

3.2.2 PropertyBag Stream ("Docf_\005Bagaaqy23kudbhchAaq5u2chNd") 

3.2.2. 1 "CONTENTS" Stream 

3. 2. 2. 1.1 CodePage 

3. 2. 2. 1.2 Locale 

3. 2. 2. 1.3 Behavior 

3. 2 . 2 . 1.4 Dictionary 

3. 2. 2. 1.5 DisplayColour 

3. 2. 2. 1.6 MyStream 

3. 2. 2. 1.7 Price(GBP) 

3. 2. 2. 1.8 MyStorage 

3. 2. 2. 1.9 CaseSensitive 

3.2.2.1.10 CASESENSITIVE 

3. 2. 2. 2. -yprop6" Stream 

3. 2. 2. 3 "propl2" Storage 



[MS-OLEPS] - V20111214 

Object Unking and Embedding (OLE) Property Set Data Structures 
Copyright © 2011 Microsoft Corporation. 


35 

35 

35 

36 

37 

37 

39 

40 
40 

40 

41 
41 

41 

42 

42 

43 
43 

43 

44 
44 

44 

45 
45 
45 

45 

46 
46 
46 
49 
49 

49 

50 
53 

53 

54 

54 

55 

56 

57 

57 

58 

59 
62 
64 


Release: Wednesday, December 14, 2011 



1 Introduction 


This document specifies the Object Linking and Embedding (OLE) Property Set Data Structures 
(OLEPS), a generic persistence format for sets of properties typically used to associate simple 
typed metadata with a file. In order for an application to make metadata discoverable to other 
software, it chooses a property set format, either a well-known published format or an 
application-defined format, and writes a property set containing the properties specified for this 
format. In combination with technologies that support multiple virtual streams in a single physical 
file, such as the Compound File Binary File Format (for details, see [MS-CFB]) or the alterpi ' 
data stream feature of certain file systems, one or more property sets can be associated wil 
This enables applications to make properties of a file discoverable to software that d ogf 
parsing application-specific portions of the file format. 


1.1 Glossary 

The following terms are defined in rMS-CFBI : 



compound file 

The following terms are defined in rMS-GLOSI : 

alternate stream 
class identifier (CLSID) 
file 

globally unique identifier (GUID) 
little-endian 
NT file system (NTFS) 

Unicode 

The following terms are specific to this documehl 

element: A stream or storage that is identified by a unique name. 

FMTID: A GUID value that identifies a property set format. 

GUID_NULL: The GUID value {00000000-0000-0000-0000-000000000000}. 

non-simple property set: A property set that is stored as a storage, which enables stream 
and storage as property types. 

property: A typed value associated with a property identifier and optionally a property name, 
property identifier: A numerical value that uniquely identifies a property in a property set. 
property name: A string value that uniquely identifies a property in a property set. 

property set: A set of properties, along with an FMTID, identifying the property set format 
isociated class identifier (CLSID). The CLSID is used to identify the application or 
ipoftfiigfhat created the property set. 

operty set format: A specification for the properties in a property set, including the 
property identifier, type, semantics, and, optionally, a property name for each property. 

simple property set: A property set that is stored as a stream and does not enable streams 
and storages as property types. 
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storage: A set of elements with an associated CLSID used to identify the application or 
component that created the storage. 

storage container: A software-provided location for a storage, 
storage format: A specification for encoding a particular type of data as a storage, 
stream: A sequence of bytes that typically encodes application data, 
stream container: A software-provided location for a stream, 
stream format: A specification for encoding a particular type of data as a stream. 

MAY, SHOULD, MUST, SHOULD NOT, MUST NOT: These terms (in all caps) are used as 
described in fRFC21191 . All statements of optional behavior use either MAY, SHOULD, j 
SHOULD NOT. 


rV 


continued availability. If 

dochelpca microsoft.com . We 
:hive site, 

as an 


1.2 References 

References to Microsoft Open Specification documents do not include a publishing year because links 
are to the latest version of the documents, which are updated frequently. References to other 
documents include a publishing year when one is available. 

1.2.1 Normative References 

We conduct frequent surveys of the normative reference 
you have any issue with finding a normative refen 
will assist you in finding the relevant information. Pl| 
http://msdn2.microsoft.com/en-us/librarv/E4BD649' 

additional source. 

[C706] The Open Group, "DCE 1.1: Remote Prl 
http://www.openqroup.org/public/pubs/cataloc 

[MS-CFB] Microsoft Corporation, " Comp( 

[MS-DTYP] Microsoft Corporatiofe> L " Wind Types ". 

[MS-LCID] Microsoft Corporation, " Windows Language Code Identifier (LCID) Reference ". 

[MS-OAUT] Microsoft Corporation, " E Al Pr oti Specifica on". 

[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 
2119, March 1997, http://www.rfc-editor.org/rfc/rfc2119.txt 

[RFC4234] Crocker, D., Ed., and Overell, P., "Augmented BNF for Syntax Specifications: ABNF", RFC 
4234, October 2005, http://www.ietf.org/rfc/rfc4234.txt 

: erences 

Corporation, "Code Pages", 

hffll nicrgsoft.com/qlobaldev/reference/cphome.mspx 

If you any trouble finding [CODEPG], please check here . 

[MS-GLOS] Microsoft Corporation, " Windows Protocols Master Glossary ". 

t 
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[MSDN-COM] Microsoft Corporation, "Component Object Model", http://msdn.rnicrosoft.com/en- 
us/librarv/aa286559.aspx 


[MSDN-FileStreams] Microsoft Corporation, "File Streams", http://msdn.microsoft.com/en- 
us/librarv/aa364404.aspx 

1.3 Overview 

The Object Linking and Embedding (OLE) Property Set Data Structures (OLEPS) enable applications 
to write metadata in a manner that is discoverable to other software. A property set consists of a set 
of properties, each of which is a typed value associated with a numerical property identifier, and 
a globally unique identifier (GUID) format identifier, or FMTID, which can be used to identify 
the semantics and expected usage of the properties. 

Certain FMTIDs correspond to well-known, published property set formats, while other property set 
formats are application-defined. If an application defines its own property set format or formats, the 
developer of the application will typically publish (through an out-of-band mechanism) the 
application-defined formats and FMTIDs so that other software can recognize and use the properties 
in a meaningful way. In either case, the semantics and expected usage of properties in a property 
set are dependent on the property set format. This document does not specify the semantics of 
properties or assignment of property identifiers in general, nor does it specify the mechanism to be 
used for publishing property set formats. 

The OLE Property Set Data Structures Specification consists of the following: 

■ The specification for storing a property set as a stream or storage suitable for use with a file 
format or other storage technology that provides containers for these abstract types. 

■ Standard bindings for storing property set streams and storages in a compound file (for details 
see rMS-CFBP . and for storing property sets in alternate streams of a file, in file systems that 
provide such a feature. An example of a file system that provides alternate streams is NTFS (for 
more information, see rMSDN-FileStreamsl ). 

■ The specifications for the well-known property set formats, Propertvldentifier and Property Baa . 

1.3.1 Background 

A stream is a sequence of bytes that typically encodes application data. An example of a stream is 
the data contents of ^n ordinary file. A stream container is a software-provided location for a 
stream. An example of a stream container is a file for which the provider is the file system. In order 
for an application to store data in a stream container, the application can either define a stream 
format— a specification for encoding a particular type of data as a stream— or use an existing 
stream format. 

A storage is a collection of elements for which each element consists of either a stream or a 
storage and a unique name that identifies the element within the storage. The definition of a storage 
is recursive. For example, a storage may contain another storage, which may in turn contain a third 
storage, and so on. In addition to its elements, a storage also has an associated class identifier 
(CLS1D), which is a GUID value typically used to identify the application or component that created 
the storage. For example, an application that implements a Component Object Model (COM) class 
(for more information, see rMSDN-COMl ) capable of parsing a storage might set the associated 
CLSID to the CLSID of this COM class. A storage container is a software-provided location for a 
storage. An example of a storage container is a compound file. In order for an application to store 
data in a storage container, it either defines a storage format— a specification for encoding a 
particular type of data as a storage— or uses an existing storage format. 
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The specification for standard property set stream and storage names in section 2.23 assumes that 
storage containers provide element-naming that is case-insensitive for at least the characters A- 
Z/a-z. Compound files have this property. 


1.3.2 Properties and Property Sets 

A property is a typed value associated with a numerical identifier, known as the property identifier. 
OLEPS also enables a property to be optionally associated with a string known as the property 
name. Typically, this is used to provide a human-readable description of the semantics of tbe. 
property. A property set is a set of properties, along with a globally unique identifier (GUID) format 
identifier, or FMTID. The FMTID serves to identify the property set format, which is a specification 
for the properties in the property set, including the property identifier, type, semantics and, 
optionally, a property name for each property. Property identifiers and property names (if present) 
of the properties in a property set are distinct such that both property identifiers and property 
names (if present) uniquely identify properties. 

To accommodate specialized uses of property sets, OLEPS also enables a property set to have an 
associated class identifier (CLSID), a GUID value typically used to identify the application or 
component that created the property set. For example, an application that persists an instance of a 
Component Object Model (COM) class in a property set might set the associated CLSID to the CLSID 
of this COM class. 

Two kinds of property sets are defined: simple property sets and non-simple property sets. 
Non-simple property sets allow a set of property types that are a superset of the types allowed by 
simple property sets. In particular, streams and storages are valid types for properties in a non- 
simple property set, whereas these types are not vglid in a simple property set. Additionally, the 
specification for simple property set is a stream format, whereas the specification for non-simple 
property sets is a storage format. 


1.4 Relationship to Protocols and Other Structures 

|J.o be stored in a compound file (for details, see fMS- 


The OLEPS protocol enables property s 
CFBl j. 


1.5 Applicability Statement 

OLEPS is appropriate for writing simple metadata to a file, especially when this metadata needs to 
be discoverable by other software. It is most appropriate when the file format itself does not provide 
a format-specific mechanism for writing typed property. 




1.6 Versioning and Localization 

This document covers versioning issues in the following areas: 

■ Structure Versions: The PropertvSetStream packet supports two versions: version 0 and 
version 1. Version 0 does not support some of the property types in the PropertyType 
enumeration and does not support the special Behavior property . These versions are defined in 
section 2. 

Localization: The encoding of strings in the CodePaqeStrina and Propertvldentifier packets is 
dependent on a property set's CodePaqe property . Property sets optionally have an informational 
Locale property to identify the language for strings in the property set. Localization-dependent 
structure content is specified in section 2. 
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This document specifies two versions for property sets: version 0 and version 1. Version 1 supports 
additional property types and a special Behavior property. The granularity for versioning is the 
Propertvldentifier packet, which usually contains a single property set. Therefore, in general, it is 
possible for a file to contain both version 0 and version 1 property sets. 
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2 Structures 


Field types in packet diagrams are defined by the packet diagram and the field descriptions. All 
fields in packet diagrams use little endian byte ordering unless otherwise stated. 

This protocol uses the following types specified in rMS-DTYPl and rMS-OAUTI . 


Type 

Reference 

HRESULT 

[MS-DTYP], section 2.2.18 

FILETIME 

[MS-DTYP], section 2.3.1 

GUID 

[MS-DTYP], section 2.3.2 

LCID 

[MS-DTYP], section 2.3.4 

CURRENCY 

[MS-OAUT], section 2.2.24 

DATE 

[MS-OAUT], section 2.2.25 

VARIANT BOOL 

[MS-OAUT], section 2.2.27 


2.1 Property Identifier 
The Propertyldentifier data type represents the property identifier dfPfiPSperty in a property set. 
This type is declared as follows: 

typedef 



The PropertyType enumeration represents the type of a property in a property set. The set of 
:ypes supported depends on the version of the property set, which is indicated by the Version field 
of the PropertvSetStream packet. In addition, the property types not supported in simple property 
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sets are specified as such. PropertyType is an enumeration, which MUST be one of the following 
values: 


This type is declared as follows: 

typedef unsigned int PropertyType; 


Value 

Meaning 

VT EMPTY 

0x0000 

Type is undefined, and the minimum property set version is 0.. 

VT NULL 

0x0001 

Type is null, and the minimum property set version is 0. 

VT_I2 

0x0002 

Type is 16-bit signed integer, and the minimum property set version is 0. 

VT 14 

0x0003 

Type is 32-bit signed integer, and thejlMnimum property set veraon is 0. 

VT_R4 

0x0004 

Type is 4-byte (single-precision) IEEE floating-point number, and the 

minimum property set version is 0. 

VT R8 

0x0005 

Type is 8-byte (double-precision) IEEE floating-point number, and the 

minimum property set version is 0. 

VT_CY 

0x0006 

TvDe is CURRENCY, and the minimum DroDertv set version is 0. 

VT DATE 

0x0007 

Type is DATE, and the minimum property set version is 0. 

VT BSTR 

0x0008 

TvDe is CodePaaeStrirTfelmd the minimum DroDertv set version is 0. 

VT_ERROR 

OxOOOA 

TvDe is HRESULT. aHlThe minimum DroDertv set version is 0. 

VT BOOL 

OxOOOB 

TvDe is VARIANT BOOL, and the minimum DroDertv set version is 0. 

VT DECIMAL 

OxOOOE 

TvDe is DECIMAL, and the minimum DroDertv set version is 0. 

VT_I1 

Afype is 1-byte signed integer, and the minimum property set version is 1. 

0x0010 


VTJJIl 

0x0011 

Type is 1-byte unsigned integer, and the minimum property set version is 

0 . 

0x0012 

Type is 2-byte unsigned integer, and the minimum property set version is 

0 . 

VT UI4 

0x0013 

Type is 4-byte unsigned integer, and the minimum property set version is 

0 . 
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Value 

Meaning 

VT_I8 

0x0014 

Type is 8-byte signed integer, and the minimum property set version is 0. 

VT UI8 

0x0015 

Type is 8-byte unsigned integer, and the minimum property set version is 

0 . 

VT_INT 

0x0016 

Type is 4-byte signed integer, and the minimum property set versionis 1. 

VT UINT 

0x0017 

Type is 4-byte unsigned integer, and the minimum property set version is 

1 . 

VT LPSTR 

OxOOlE 

Type is CodePageString, and the minimum property set version is 0. 

VT LPWSTR 

OxOOlF 

TvDe is UnicodeStrina. and the minimum DroDertv set version is 0. 

VT_FILETIME 

0x0040 

Type is FILETIME, and the minimum property set version is 0. 

VT BLOB 

0x0041 

TvDe is binary larae obiect IBLOBI. and the minimum DroDertv set version is 

0 . 

VT STREAM 

0x0042 

Type is Stream, and the minimum property set version is 0. VT_STREAM is 
not allowed in a simple property set. 

VT_STORAGE 

0x0043 

Type is Storage, and the minimum property set version is 0. VT_STORAGE is 
not allowed in a simple property set 

VT STREAMED Object 
0x0044 

Type is Stream representing an Object in an application-specific manner, and 
the minimum property set version is 0. VT_STREAMED_Object is not allowed 
in a simple property set 

VT STORED Object 

0x0045 

Type is Storage representing an Object in an application-specific manner, 
and the minimum property set version is 0. VT_STORED_Object is not 
allowed in a simple property set 

VT BLOB Object 

0x0046 

Type is b|LQB representing an object in an application-specific manner. The 
minimum property set version is 0. 

VT CF 

0x0047 

TvDe is Pmeertvldentifier. and the minimum DroDertv set version is 0. 

VT_CLSID 

0x0048 

Type is CLSID, and the minimum property set version is 0. 

VT VERSIONED STREAM 
0x0049 

TvDe is Stream with aDDlication-SDecific version GUID (VersionedStreamj. 

The minimum property set version is 0. VT_VERSIONED_STREAM is not 
allowed in a simple property set. 

VT_VECTOR |^Fl2 

0x1002 

Type is Vector of 16-bit signed integers, and the minimum property set 
version is 0. 

VT VECTOR | VT 14 

0x1003 

Type is Vector of 32-bit signed integers, and the minimum property set 
version is 0. 
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Value 


Meaning 


Type is Vector of 4-byte (single-precision) IEEE floating-point 
numbers, and the minimum property set version is 0. 


Type is Vector of 8-byte (double-precision) IEEE floating-point 
numbers, and the minimum property set version is 0. 


Type is Vector of CURRENCY, and the minimum property set version is 0. 


VT_VECTOR | VT_ERROR Type is Vector of HRESULT, and the minimum property set version is 0. 


VT_VECTOR | 
VT_VARIANT 
OxlOOC 


nu uie minimum uiuutii 
iperties, and the n^nim 


Type is Vector of 1-byte signed integers and the minimum property set 
version is 1. 


VT_VECTOR | VT_UI1 Type is Vector of 1-byte unsigned integers, and the minimum property 





VT_VECTOR | VT_UI2 Type is Vector of 2-byte unsigned integers, and the minimum property 


0x1012 set version is 0. 

VT_VECTOR | VT_UI4 Type ' s Vector of 4-byte unsigned integers, and the minimum property 

0x1013 set version is 0. 

VT_VECTOR | VT_I8 Type is Vector of 8-byte signed integers, and the minimum property set 

0x1014 version is 0. 

VT_VECTOR | VT_UI8 Type is Vector of 8-byte unsigned integers and the minimum property set 

0x1015 version isA> 

VT_VECTOR |^VT_LPSTR Type is Vector of CodePageString, and the minimum property set version is 
OxlOlE 0. 


< 1 


VT VECTOR^f 

VT.LPWSTR 

OxlOlF 

VT_VECTOR | 


Type is Vector of UnicodeString, and the minimum property set v 


Type is Vector of FILETIME, and the minimum property set version is 0. 
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Value 


Meaning 


Type is Vector of CLSID, and the minimum property set version is 0. 


Type is Array of 16-bit signed integers, and the minimum property set 


Type is Array of 32-bit signed integers, and the minimum property s< 


Type is Array of 4-byte (single-precision) IEEE floating-point numbers, 

and the minimum property set version is 1. 

Type is IEEE floating-point numbers, and the minimumproperty set 


Type is Array of CURRENCY, and the minimum property set version is 1 


Type is Array of DATE, and the minimum property set version i: 


Type is Array of CodePageString, and the minimum property set version is 1. 


Type is Array of HRESULT, and the minimum property set version is 1. 


Type is Array of VARIANT_BOOL, and the minimum property set version 


Type is Array of variable-typed properties, and the minimum property set 


Type is Array of DECIMAL, and the minimum property set v 


Type is Array of 1-byte signed integers, and the minimum property set 


Type is Array of 1-byte unsigned integers, and the minimum property set 


Type is Array of 2-byte unsigned integers, and the n 


Type is Array of 4-byte unsigned integers, and the minimum property set 


9 


Type is Array of 4-byte signed integers, and the minimum property set 


Type is Array of 4-byte unsigned integers, and the n 
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2.3 CURRENCY (Packet Version) 


The CURRENCY (Packet Version) packet represents a CURRENCY as specified in rMS-OAUTI section 
2.2.24. 


012345678901234567890123456 


LAJlJLj 1 


int64 (8 bytes): The value of the int64 field specified in [MS-OAUT] section 2.2.24 . 

2.4 DATE (Packet Version) 

The DATE (Packet Version) packet represents a DATE as specified in rMS-OAUTI section 2.2.25. 




Value (8 bytes): The value of the DATE is an 8-byte IEEE floating-point number, as specified 
in rMS-OAUTI section 2.2.25. 

2.5 CodePageString 

The CodePageString packet represents a string whose encoding depends on the value of the 
property set's CodePaqe property . 




Characters (variable) 


9 


Size (4 bytes): The size in bytes of the Characters field, including the null terminator, but not 
including padding (if any). If the property set's CodePage property has the value 
3 _WINUNICODE (0x04B0), then the value MUST be a multiple of 2. 

:ers (variable): If Size is zero, this field MUST be zero bytes in length. If Size is 
:ro and the CodePage property set's CodePage property has the value CP_WINUNICODE 
(0x04B0), then the value MUST be a null-terminated array of 16-bit Unicode characters, 
followed by zero padding to a multiple of 4 bytes. If Size is nonzero and the property set's 


CP_W1 

Charactc 

nonzei 
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CodePage property has any other value, it MUST be a null-terminated array of 8-bit characters 
from the code page identified by the CodePage property, followed by zero padding to a 
multiple of 4 bytes. The string represented by this field MAY contain embedded or additional 
trailing null characters and an OLEPS implementation MUST be able to handle such strings. 
However, the manner in which strings with embedded or additional trailing null characters are 
presented by the implementation to an application is implementation-specific. <!>. For 
maximum interoperability, an OLEPS implementation SHOULD NOT write strings with 
embedded or trailing null characters unless specifically requested to do so by an applic 

2.6 DECIMAL (Packet Version) 

The DECIMAL (Packet Version) packet represents a DECIMAL as specified in [MS-OAUT1 se 
2.2.26. 



01234567 


9 0 1 2 3 4 5 


9 0 12 




HH 


wReserved (2 bytes): MUST be set to zero and MUST be ignored, 
scale (1 byte): The value of the scale field specified in [MS-OAUT] section 2.2.26. 
sign (1 byte): The value of the sign field specified in rMS-OAUTI section 2.2.26. 
Hi32 (4 bytes): The value of the Hi32 field specified in [MS-OAUT! section 2.2.26. 
Lo64 (8 bytes): The value of the Lo64 field specified in rMS-OAUTI section 2.2.26. 
2.7 UnicodeString 

The UnicodeString packet represents a Unicode string. 



I!!!!!!!!! 


4 5 


1 2 


4 5 


Characters (variable) 


4 bytes): The length in 16-bit Unicode characters of the Characters field, including 
the null terminator, but not including padding (if any). 
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Characters (variable): If Length is zero, this field MUST be zero bytes in length. If Length is 
nonzero, this field MUST be a null-terminated array of 16-bit Unicode characters, followed by 
zero padding to a multiple of 4 bytes. The string represented by this field SHOULD NOT 
contain embedded or additional trailing null characters. 


2.8 FILETIME (Packet Version) 

The FILETIME (Packet Version) packet represents a FILETIME structure ( fMS-DTYPl section 2.3.1). 


1 2 

012345678901234567890123456 



dwLowDateTime 


dwHighDateTime 


dwLowDateTime (4 bytes): The value of the dwLowDateTime field specified in TMS-DTYP1 
section 2.3.1. 

dwHighDateTime (4 bytes): The value of the dwHighDateTime field specified in fMS-DTYPI 
section 2.3.1. 

2.9 BLOB 



Size (4 bytes): The size in bytes of the Bytes field, not including padding (if any). 

Bytes (variable): MUST be an array of bytes, followed by zero padding to a multiple of 4 bytes. 


o 


2.10 IndirectPropertyName 

The IndirectPropertyName packet represents the name of a stream or storage as used in the 
representation of the following property types in a non-simple property set: VT_STREAM (0x0042), 
VT_STORAGE (0x0043), VT_STREAMED_OBJECT (0x0044), VT_STORED_OBJECT (0x0044), and 
VT_VERSIONED_STREAM (0x0049). It MUST be represented as a CodePaqeStrinq . and its value 
MUST be derived from the property identifier of the property represented according to the following 
Augmented Backus-Naur Form (ABNF) fRFC42341 syntax. 


.^^fcproperty = "prop" propertyldentifier 


17/64 
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Where Propertvldentifier is the decimal string representation of the property identifier. This 
property identifier MUST be a valid Propertyldentifier value and MUST NOT be the property 
identifier for any of the special properties specified in section 2 . 18 . 


2.11 ClipboardData 

The ClipboardData packet represents clipboard data. 
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2.13 VersionedStream 

The VersionedStream packet represents a stream with an application-specific version GUID . 



VersionGuid (16 bytes): MUST be a GUID (Packet Ytegon). 

StreamName (variable): MUST be an IndirectPropertvIMame . 

2.14 Vector and Array Property Types 

Several property types are defined to be a vector or an array of another property type, known as 
the property's scalar type. Vector types, indicated by a PropertvType value with the VT_VECTOR 
(0x1000) bit set, are simple, one-dimensional arrays of the scalar type. Array types, indicated by a 
PropertyType value with the VT_ARRAY (0x2000) bit set, are multi-dimensional arrays of the scalar 
type, with elements in row-major order (that is, elements with indices differing only in that the 
highest-numbered dimensions are consecutive). All such types are represented by a header, which 
provides information on the size and dimensions of the vector or array, followed by a sequence of 
scalar values. 

The following sections provide details on the representation of vector and array property types. 

2.14.1 Property Types in Variable-Typed Vectors and Arrays 

The property types VT_VECTOR | VT_VARIANT (OxlOOC) and VT_ARRAY | VT_VARIANT 

(0x200C) are variable-typed sequences in which each scalar value has its own type. The types of 
the individual scalar values in such a property MUST be taken from the following subset of the 
PropertvType enumeration values. 
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Value 

Allowed in VT_VECTOR | 

VT_VARIANT property? 

Allowed in VT_ARRAY | 

VT_VARIANT property? 

VT_CY (0x0006) 

Yes 

Yes 

VT_DATE (0x0007) 

Yes 

Yes 

VT_BSTR (0x0008) 

Yes 

Yes 

VT ERROR 
(OxOOOA) 

Yes 

Yes 

VT_BOOL (OxOOOB) 

Yes 

Yes 

VT_DECIMAL 

(OxOOOE) 

No 

Yes 

VT_I1 (0x0010) 

Yes 

Yes 

VT_UI1 (0x0011) 

Yes 

Yes 

VT_UI2 (0x0012) 

Yes 

ves 

VT_UI4 (0x0013) 

Yes 


VT_I8 (0x0014) 

Yes 

No 

VT_UI8 (0x0015) 

Yes 

No 

VT_INT (0x0016) 

No 

Yes 

VT_UINT (0x0017) 

No 

Yes 

VT LPSTR 
(OxOOlE) 


|n° 

VT_LPWSTR 

(OxOOlF) 


No 

VT_FILETIME 

(0x0040) 

- 

No 

VT_CF (0x0047) I 

YeS 

No 

VT CLSID 
(0x0048) 


No 


2.14.2 VectorHeader 


The Vectorh 

rm 

Oa 

Length 

heads 


actorHeader packet rep 


represents the number of scalar values in a vector property type. 


(4 bytes): An unsigned integer indicating the number of scalar values following the 
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2.14.3 ArrayDimension 


The ArrayDimension packet represents the size and index offset of a dimension of an array property 
type. 


1 2 3 4 5 6 7 8 


Size (4 bytes): An unsigned integer representing the size of the dimension. 

IndexOffset (4 bytes): A signed integer representing the index offset of the dimension. For 
example, an array dimension that is to be accessed with a 0-based index would have the 
value zero, whereas an array dimension that is to be accessed with a 1 -based index would 
have the value 0x00000001. 


Value 

Meaning 

0 

An array dimension that is to be accessed with a 0-based index would have the 
value zero. 

0x00000001 

An array dimension that is to beaccessed with a 1-based index would have the 
value 0x00000001. 


2.14.4 ArrayHeader 

The ArrayHeader packet represents tj 


iLsjo 



ions of an array property type. 


Type 

NumDimensions 
W Dimension 0 (variable) 

Dimension n (variable) 


9 


L= 

Type (4 bytes) 

this array pro 


4 bytes): MUST be set to the value obtained by clearing the VT_ARRAY (0x2000) bit of 
irray property's PropertvType value. 

NumDimensions (4 bytes): An unsigned integer representing the number of dimensions in the 
array property. MUST be at least 1 and at most 31. 
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Value Meaning 


An unsigned integer representing the number of dimensions in the array property. 


Dimension 0 (variable): MUST be a sequence of ArravDimension packets. 

The number of scalar values in an array property can be calculated from the ArrayH 
packet as the product of the Size fields of each of the ArrayDimension packets. 

2.15 TypedPropertyValue 

The TypedPropertyValue structure represents the typed value of a property in a prc 




Type (2 bytes): MUST be a value from the PropertvT 
property represented. 

Padding (2 bytes): MUST be set to zero, and any nonzero vafi|| SHOULD be rejected. 


Value 

~-*k X. 

0 

fc»As r*jired?^k 


Value (variable): MUST be the value of the property represented and serialized according to 
the value of Type as follows. 


Type 

Format 

VT_EMPTY (0x0000) 

MUST be zero bytes in length. 

VT_NULL (0x0001) 

MUST be zero bytes in length. 

VT_I2 (0x0 00^- 

MUST be a 16-bit signed integer, followed by zero padding to 4 
bytes. 

^T_I4 (0x0003) 

MUST be a 32-bit signed integer. 

W. R4 (0x0i3i||/ 

MUST be a 4-byte (single-precision) IEEE floating-point 
number. 

^VT_R8(0xf)005) 

MUST be an 8-byte (double-precision) IEEE floating-point 
number. 

WcY (0x0006) 

MUST be a CURRENCY (Packet Version). 

VT_DATE (0x0007) 

MUST be a DATE (Packet Version). 
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Type 

Format 

VT_BSTR (0x0008) 

MUST be a CodePaaeStrina. 

VT_ERROR (OxOOOA) 

MUST be a 32-bit unsianed inteaer reDresentina an HRESULT. 

as specified in £M : 1, section 2.2.18. 

VT_BOOL (OxOOOB) 

MUST be a VARIANT BOOL as specified in TMS-OAUT1. section 
2,2.27. followed by zero padding to 4 bytes. 

VT_DECIMAL (OxOOOE) 

MUST be a DECIMAL (Packet Version!. 

VT_I1 (0x0010) 

MUST be a 1-byte signed integer, followed by zero padding to 4 
bytes. 

VT_UI1 (0x0011) 

MUST be a 1-byte unsigned integer, followed by zero padding to 

4 bytes. 

VT_UI2 (0x0012) 

MUST be a 2-byte unsigned integer, followed by zero padding to 

4 bytes. 

VT_UI4 (0x0013) 

MUST be a 4-byte unsigned integer. 

VT_I8 (0x0014) 

MUST be an 8-byte signed integer. 

VT_UI8 (0x0015) 

MUST be an 8-byte unsigned integer. 

VT_INT (0x0016) 

MUST be a 4-byte signed integer. 

VTJJINT (0x0017) 

MUST be a 4-byte unsigned integer. 

VT_LPSTR (0x00 IE) 

MUST be a CodePageString. 

VT_LPWSTR (0x00 IF) 

MUST be a UnicodeStrina^J 

VT_FILETIME (0x0040) 

MUST be a FILETIME (Packet Version"). 

VT_BLOB (0x0041) 

MUST be a BLOB, 

VT_STREAM (0x0042) 

MUST be an indirectProDertvName. The storaae reDresentina the 
(non-simple) property set MUST have a stream element with this 
name. 

VT_STORAGE (0x0043) 

MUST be an IndirectPropertyName. The storage representing the 
Jlon-simple) property set MUST have a storage element with this 
name. 

VT_STREAMED OBJECT 
(OxO^U^T 

MUST be an IndirectPropertyName. The storage representing the 
(non-simple) property set MUST have a stream element with this 
name. 

VT STORED OBJECT 
(0x0045) 

MUST be an IndirectPropertyName. The storage representing the 
(non-simple) property set MUST have a storage element with this 
name. 

VT_BLOB_OBJECT (0x0046) 

MUST be a BLOB. 

^%CF (0x0047) 

MUST be a CliDboardData. 

VT_CLSID (0x0048) 

MUST be a GUID (Packet Version). 
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<? 


Type 

Format 

VT VERSIONED STREAM 
(0x0049) 

MUST be a VersionedStream. The storaae reDresentina the (non- 
simple) property set MUST have a stream element with the name in 

the StreamName field. 

VT VECTOR | VT 12 
(0x1002) 

MUST be a VectorHeader followed bv a seauence of 16-bit sianed 
integers, followed by zero padding to a total length that is a 
multiple of 4 bytes. 

VT VECTOR | VT 14 
(0x1003) 

MUST be a VectorHeader followed by a sequence of 32-bit signed 
integers. 

VT VECTOR | VT R4 
(0x1004) 

MUST be a VectorHeader followed by a sequence of 4-byte 
(single-precision) IEEE floating-point numbers. 

VT_VECTOR | VT_R8 
(0x1005) 

MUST be a VectorHeader followed by a sequence of 8-byte 
(double-precision) IEEE floating-point numbers. 

VT VECTOR | VT CY 
(0x1006) 

MUST be a VectorHeader followed by a sequence of CURRENCY 
(Packet Version) packets. 

VT VECTOR | VT DATE 
(0x1007) 

MUST be a VectorHeader followed by a sequence of DATE (Packet 
Version) packets. 

VT VECTOR | VT BSTR 
(0x1008) 

MUST be a VectorHeader followed by a sequence of 

CodePageString packets. 

VT_VECTOR | VT_ERROR 
(OxlOOA) 

MUST be a VectorHeader followed by a sequence of 32-bit 
unsigned integers representing HRESULTs, as specified in [MS- 
DTYP], section 2.2.18. 

VT_VECTOR | VT_BOOL 
(OxlOOB) 

MUST be a VectorHeader followed by a sequence of 

VARIANT_BOOL as specified in [MS-OAUT], section 2.2.27. 
followed by zero padding to a total length that is a multiple of 4 
bytes. 

VT_VECTOR | VT_VARIANT 
(OxlOOC) 

MUST be a VectorHeader followed by a sequence of 

Typed PropertyValue packets. 

VT VECTOR | VT 11 
(0x1010) 

MUST be a VectorHeader followed by a sequence of 1-byte signed 
integers, followed by zero padding to a total length that is a 
multiple of 4 bytes. 

VT VECTOR | VT UI1 
(0x1011) 

MUST be a VectorHeader followed by a sequence of 1-byte 
unsigned integers, followed by zero padding to a total length that 
is a multiple of 4 bytes. 

VT VECTOR | VT UI2^ 
(0x1012) 

MUST be a VectorHeader followed by a sequence of 2-byte 
unsigned integers, followed by zero padding to a total length that 
is a multiple of 4 bytes. 

VT VECTOR | VT UI4 
(oxio'i'S) 

MUST be a VectorHeader followed by a sequence of 4-byte 
unsigned integers. 

VT VECTOR | VT 18 
(0x1014) 

MUST be a VectorHeader followed by a sequence of 8-byte signed 
integers. 

VT_VECTOR | VT_UI8 
(0x1015) 

MUST be a VectorHeader followed by a sequence of 8-byte 
unsigned integers. 
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Type 

Format 

VT VECTOR | VT LPSTR 
(OxlOlE) 

MUST be a VectorHeader followed by a sequence of CodePageString 
packets. 

VT VECTOR | VT LPWSTR 
(OxlOlF) 

MUST be a VectorHeader followed by a sequence of UnicodeString 
packets. 

VT VECTOR | VT FILETIME 
(0x1040) 

MUST be a VectorHeader followed by a sequence of FILETIME 
(Packet Version) packets. 

VT_VECTOR | VT_CF 
(0x1047) 

MUST be a VectorHeader followed by a sequence of ClipboardData 
packets. 

VT VECTOR | VT CLSID 
(0x1048) 

MUST be a VectorHeader followed by a sequence of GUID (Packet 
Version) packets. 

VT_ARRAY | VT_I2 (0x2002) 

MUST be an ArravHeader followed bv a seauence of 16-bit sianed 
integers, followed by zero padding to a total length that is a 
multiple of 4 bytes. 

VT_ARRAY | VT_I4 (0x2003) 

MUST be an ArrayHeader followed by a secpjence of 32-bit signed 
integers. 

VT_ARRAY | VT_R4 
(0x2004) 

MUST be an ArrayHeader followed by a sequence of 4-byte 
(single-precision) IEEE floating-point numbers. 

VT_ARRAY | VT_R8 
(0x2005) 

MUST be an ArrayHeader followed by asSpence of 8-byte 
(double-precision) IEEE floating-point numbers. 

VT ARRAY | VT CY 
(0x2006) 

MUST be an ArrayHeader followed by a sequence of CURRENCY 
(Packet Version) packets. 

VT ARRAY | VT DATE 
(0x2007) 

MUST be an ArrayHeader followed by a sequence of DATE (Packet 
Version) packets. 

VT_ARRAY | VT_BSTR 
(0x2008) 

MUST be an ArrayHeader followed by a sequence of 

CodePageString packets. 

VT_ARRAY | VT_ERROR 
(0x200A) 

MUST be an ArrayHeader followed by a sequence of 32-bit 
unsigned integers representing HRESULTs, as specified in [MS- 
DTYP], section 2.2.18. 

VT ARRAY | VT BOOL 
(0x200B) 

MUST be an ArrayHeader followed by a sequence of 

VARIANT_BOOL as specified in [MS-OAUT], section 2.2.27. 
followed by zero padding to a total length that is a multiple of 4 
bytes. 

VT_ARRAY | VT_VARIANT 

^0x200l^L 

MUST be an ArrayHeader followed by a sequence of 
TypedPropertyValue packets. 

VT_ARRAY | VT„DECIMAL 
(0x200E) 

MUST be an ArrayHeader followed by a sequence of DECIMAL 
(Packet Version) packets. 

|R/T_ARRAr| VT_I1 (0x2010) 

MUST be an ArrayHeader followed by a sequence of 1-byte signed 
integers, followed by zero padding to a total length that is a 
multiple of 4 bytes. 

VT ARRAY | VT UI1 
(0x2011) 

MUST be an ArrayHeader followed by a sequence of 1-byte 
unsigned integers, followed by zero padding to a total length that 
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Type 

Format 


is a multiple of 4 bytes. 

VT ARRAY | VT UI2 
(0x2012) 

MUST be an ArrayHeader followed by a sequence of 2-byte 
unsigned integers, followed by zero padding to a total length that 
is a multiple of 4 bytes. 

VT ARRAY | VT UI4 
(0x2013) 

MUST be an ArrayHeader followed by a sequence of 4-byte 
unsigned integers. 

VT ARRAY | VT INT 
(0x2016) 

MUST be an ArrayHeader followed by a sequence of 4-byte signed 
integers. 

VT_ARRAY | VT_UINT 
(0x2017) 

MUST be an ArrayHeader followed by a sequence of 4-byte 
unsigned integers. 


2.16 DictionaryEntry 

The DictionaryEntry packet represents a mapping between a property identifier and a property 




Propertyldentifier (4 bytes): An unsigned integer representing a property identifier. MUST be 
a valid Propertyldentifier value in the range 0x00000002 to 0x7FFFFFFF, inclusive (this 
specifically excludes the property identifiers for any of the special properties specified in 
section 2.18) . 

Length (4 bytes): If the property set's CodePaqe property has the value CP_WINUNICODE 
(0x04B0), MUST be the length of the Name field in 16-bit Unicode characters, including the 
null terminator but not including padding (if any). Otherwise, MUST be the length of the 
NaqMffield indirbit characters, including the null terminator. 

Name (variable): If the property set's CodePage property has the value CP_WINUNICODE 
(0x04B0), MUST be a null-terminated array of 16-bit Unicode characters, followed by zero 
padding to a multiple of 4 bytes. Otherwise, MUST be a null-terminated array of 8-bit 
characters from the code page identified by the CodePage property and MUST NOT be padded. 

ctionary 

iary packet represents all mappings between property identifiers and property names in a 
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NumEntries 


Entry 0 (variable) 


Entry 1 (variable) 


Entry n (variable) 


Padding (variable) 


NumEntries (4 bytes): (4 bytes) An unsignedMnteger representing the number of entries in 
the Dictionary. 

Entry 1 (variable): All Entry fields MUST be a sequence of DictionarvEntrv packets. Entries are 
not required to appear in any particular order. 

Padding (variable): Padding, if necessary, to a total length that is a multiple of 4 bytes. 

2.18 Special Properties 

The following sections provide additional information on properties that have special representation, 
usage, or restrictions. 


2.18.1 Dictionary Property 

The Dictionary property, if present, MUST have a property identifier of 0x00000000 and MUST NOT 
have a property name. Unlike other properties, which are represented as TvpedPropertvValue 
packets, the Dictionary property MUST be represented as a Dictionary packet. A property set in 
which any properties have property names MUST have a Dictionary property. 

The Dictionary property MUST NOT have multiple entries with the same property identifier or 
entries with the same property name. Property names MUST be compared in a case- 
lsensitive manner unless the property set has a Behavior property with the value 0x00000001, in 
||[ch case property names MUST be compared in a case-sensitive manner. 


CodePage Property 


I 8 

The CodePage property MUST have the property identifier 0x00000001, MUST NOT have a property 
name, and MUST have type VT_I2 (0x0002). Every property set MUST have a CodePage property 
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and its value MUST be a valid code page identifier as specified in rCQDEPGI . Its value is selected in 
an implementation-specific manner. <2>, 


The CodePage property of a property set affects the representation of the CodePaoeStrinq and 
DictionarvEntry packets. The value CP_WINUNICODE (0x04B0) indicates that the strings in these 
packets are encoded as arrays of 16-bit Unicode characters. Any other value indicates that the 
strings in these packets are encoded as arrays of 8-bit characters from the code page identified. 


2.18.3 Locale Property 

The Locale property, if present, MUST have the property identifier 0x80000000, MUST NOT have a 
property name, and MUST have type VT_UI4 (0x0013). If present, its value MUST be a valid 
language code identifier as specified in rMS-LCIDI . Its value is selected in an implementation- 
specific manner. <3> 

2.18.4 Behavior Property 

The Behavior property, if present, MUST have the property identifier 0x80000003, MUST NOT have 
a property name, and MUST have type VT_UI4 (0x0013). A version 0 property set, indicated by the 
value 0x0000 for the Version field of the PropertvSetStream packet, MUST NOT have a Behavior 
property. 

If the Behavior property is present, it MUST have one of the following values. 


Value 

Meaning 

0x00000000 

Property names are case-insensitive (default). 

0x00000001 

Property names are case-sensitive. 


2.19 PropertyldentifierAndOffset 

The PropertyldentifierAndOffset packet is used in the PropertvSet packet to represent a property 
identifier and the byte offset of the property in the PropertySet packet. 




Propertyldentifier 


Propertyldentifier (4 bytes): An unsigned integer representing the property identifier of a 
property in the property set. MUST be a valid Propertyldentifier value. 

Offset (4 bytes): An unsigned integer representing the offset in bytes from the beginning of 
the PropertySet packet to the beginning of the Property field for the property represented. 
MUST be a multiple of 4 bytes. 

2.20 PropertySet 

The PropertySet packet represents a property set. 
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1 2 3 

01234567890123456789012345678901 


Size 


NumProperties 


PropertyldentifierAndOffset 0 (variable) 


PropertyldentifierAndOffset n (variable) 


Property 0 (variable) 


Property n (variable) 


Size (4 bytes): MUST be the total size in bytes of the PropertySet packet. 


NumProperties (4 bytes): An unsigned integer representing the number of properties in the 
property set. 

PropertyldentifierAndOffset 0 (variable): All PropertyldentifierAndOffset fields MUST be a 
sequence of PropertyldentifierAndOffset packets. The sequence MUST be in order of increasing 
value of the Offset field. Packets are not required to be in any particular order with regard to 
the value of the Propertyldentifier field. 


Property 0 (variable): Each Property field is a sequence of property values, each of which 
MUST be represented by a Typed PropertvValue packet or a Dictionary packet in the special 
case of the Dictionary property . 


2.21 PropertySetStream 

im packet specifies the stream format for simple property sets and the stream 
ENTS stream in the Non-Simple Property Set Storage Format . A simple property 
;ented by a stream containing a PropertySetStream packet. 

tream packet usually represents exactly one property set, but for historical 
imentSummarylnfo and UserDefinedProperties property sets are represented in 
uie idiTTP^n this special case, a PropertySetStream might represent two property sets. 

An implementation SHOULD enforce a limit on the total size of a PropertySetStream packet. This 
limit MUST be at least 262,144 bytes, and for maximum interoperability SHOULD <4> be 2,097,152 
gbytes. 

t 
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ByteOrder (2 bytes): MUST be set to OxFFFE. 


Version (2 bytes): An unsigned integer indicating the version number of the property set (or 
property sets). MUST be 0x0000 or 0x0001. An OLEPS implementation MUST accept version 0 
property sets and SFIOULD <5> also accept version 1 property sets. This field MUST be set to 
0x0001 if the property set or property sets use any of the following features not supported by 
version 0 property sets: 

■ Property types not supported for version 0 property sets, as specified in the PropertvTvpe 
enumeration. 

■ The Behavior property . 


If the property set does not use any of these features, this field SFIOULD be set to 0x0000 for 
maximum interoperability. 


Value 

Meaning 

0x0000 

Version 0 property sets will be used. 

0x0001 

Version 1 property sets will be used. 


Systemldentifier (4 bytes): An implementation-specific <6> value that SFIOULD be ignored, 
except possibly to report this value to applications. It SFIOULD NOT be interpreted by the 
OLEPS implementation. 

CLSID (16 bytes): MUST be a GUID (Pa^^Version) packet representing the associated CLSID 
of the property set (or property sets). If no CLSID is provided by the application, it SFIOULD 
be set to GUID_NULL by default. 

NumPropertySets (4 bytes): An unsigned integer indicating the number of property sets 
represented by this PropertySetStream structure. MUST be either 0x00000001 or 
0x00000002. 


Value 

Meaning 

0x00000001 

This structure contains one property set. 

0x00000002 

This structure contains two property sets. The optional fields for PropertySet 1 are 
present. 



FMTIDO (16 bytes): A GUID that MUST be set to the FMTID of the property set represented by 
^gje field PropertySet O. If NumPropertySets has the value 0x00000002, then this GUID 
;t be set to FMTID_DocSummaryInformation ({D5CDD502-2E9C-101B-9397- 
lf)2B2CF9AE». 

bytes): An unsigned integer that MUST be set to the offset in bytes from the 
:ginning of this PropertySetStream structure to the beginning of the field PropertySet 0. 

(16 bytes): If NumPropertySets has the value 0x00000002, it MUST be set to 

FMTID_UserDefinedProperties ({D5CDD505-2E9C-101B-9397-08002B2CF9AE}). Otherwise, it 
MUST be absent. 
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Offsetl (4 bytes): If NumPropertySets has the value 0x00000002, it MUST be set to the 
offset in bytes from the beginning of this PropertySetStream structure to the beginning of the 
field PropertySet 1. Otherwise, it MUST be absent. 

PropertySetO (variable): MUST be a PropertySet packet. 

PropertySetl (variable): If NumPropertySets has the value 0x00000002, it MUST be a 
PropertySet packet. Otherwise, it MUST be absent. 

Padding (variable): Contains additional padding added by the implementation. If present, 
padding MUST be zeroes and MUST be ignored. 

2.22 Non-Simple Property Set Storage Format 

A non-simple property set MUST be represented by a storage. This storage MUST have a stream 
element with the name "CONTENTS", which MUST contain a PropertySetStream pa^^t. The CLSID 
of the storage MUST be set to the associated CLSID of the property set from the CLSID field of the 
PropertySetStream packet. 


In addition, the property set MUST have an element for each property of the following types: 


Property Type 

Element Type 

VT_STREAM (0x0042) 

stream 

VT_STORAGE(0x0043) 

storage 

VT_STREAMED_OBJECT (0x0044) 

stream 

VT_STORED_OBJECT (0x0044) 

storage 

VT_VERSIONED_STREAM (0x0049) 

stream 


Each of these elements MUST have the name specified in the property's IndirectPropertvName 
packet. 


2.23 Property Set Stream and Storage Names 

A stream or storage representing a property set might be an element of a storage. For example, the 
standard binding for property set streams or storages in a compound file requires each to be an 
element of the root storage of the file. This section specifies a standard mapping between a property 
set's FMTID and the name for the stream or storage element representing the property set, so that 
property sets stored in this way are discoverable. 

An OLEPS implementation SFIOULD provide a mechanism by which elements with names derived 
according to this standard mapping are used for property sets, although the implementation 
MAY <7> additionally provide one or more other mechanisms that do not follow this convention. For 
example, the implementation might provide a mechanism by which a property set can be stored in 
i arbitrary application-provided stream container or storage container. 

le following ABNF l~RFC42341 syntax specifies the standard names for property set streams and 

0T3Q6S. 

Prope^^^etStreamOrStorageName = %x05 ("SummaryXnformation" / 

"DocumentSummarylnformation" / "Globallnfo" / "ImageContents" / 

"Imagelnfo" / <26> (ALPHA / "0" / "1" / "2" / "3" / "4" / "5") ) 
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The special-case FMTID values listed in the following table MUST be mapped to the names as 
specified in the table. 


FMTID 

Stream or storage name 

FMTID Summarylnformation {F29F85E0-4FF9-1068-AB91- 
08002 B27B3D9} 

"\005SummaryInformation" 

FMTID DocSummarylnformation {D5CDD502-2E9C-101B-9397- 
08002 B2CF9AE} 

"\005DocumentSummaryInformation" 

FMTIDJJserDefinedProperties {D5CDD505-2E9C-101B-9397- 
08002 B2CF9AE} 

"\005DocumentSummaryInformation" 

FMTID_GlobalInfo {56616F00-C154-11CE-8553-00AA00A1F95B} 

"\005Globallnfo" 

FMTID ImageContents {56616400-C154-11CE-8553- 
00AA00A1F95B} 

"\005ImageContents" 

FMTID_ImageInfo {56616500-C154-11CE-8553-00AA00A1F95B} 

"\0051magelnfo" 


All other FMTID values MUST be mapped to names as follows: 

1. Start with the 128-bit GUID (Packet Version) representation of the FMTID and append 2 zero bits 
for a total of 130 bits. 

2. Split the 130 bits into 26 groups of 5 consecutive bits each. 

3. Map each group to a character as specified in the following table. Character mappings are case- 
insensitive, and an implementation MAY <8> convert characters to uppercase. 


Bits 

Character 

Bits 

Character 

- 

Character 

Bits 

Character 

00000 

a 

01000 

i 

10000 

q 

11000 

y 

00001 

b 

01001 


10001 

r 

11001 

z 

00010 

c 

01010 


10010 

s 

11010 

0 

00011 

d 

01011 

i 

10011 

t 

11011 

i 

00100 

e 

01100 

m 

10100 

U 

11100 

2 

00101 


01101 

n 

10101 

v 

11101 

3 

00110 

g 

OHIO 

0 

10110 

w 

11110 

4 

OOlg 

h 

01111 

p 

10111 

X 

11111 

5 


n or storage name is the character "\005" followed by the 26 characters obtained from 
mapping. 
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2.24 Standard Bindings 


The following sections specify standard bindings that can be used to associate property sets with a 
file, so that property sets stored in this manner are discoverable to other implementations. An 
OLEPS implementation SHOULD support the Compound File binding for compound files. An 
implementation MA Y<9> additionally support the alternate stream binding if the file system 
supports alternate streams, but this binding MUST NOT be used for compound files. 

2.24.1 Compound File Binding 

To associate a property set with a compound file, the stream or storage representing the 
set MUST be an element of the compound file's root storage and MUST have the staj 
specified in section 2.23 . 

2.24.2 Alternate Stream Binding 

Some file systems provide a feature where a file can have alternate, named strean 
the main data stream of the file. For example, NTFS has such a feature (see l~MSDI 
more information). The alternate stream binding enables property sets to b 
alternate streams, such that property sets can be associated with- 

2.24.3 Control Stream 

A file that has one or more property sets associated withTi 
MUST have a control stream, which is an alternate stream with: the i 
8e41-00c04fb9386d}". This stream MUST contain the following padet. 





irvedl (2 bytes): MUST be set to zero, and nonzero values MUST be rejected. 

(2 bytes): MUST be set to zero, and MUST be ignored. 

itate (4 bytes): An application-provided value that MUST NOT be interpreted by 
implementation. If the application did not provide a value, it SHOULD be set to 

CLSID (16 bytes): An application-provided value that MUST NOT be interpreted by the OLEPS 
implementation. If the application did not provide a value, it SHOULD be absent. 
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2.24.4 Simple Property Set Stream 


A simple property set MUST be represented by an alternate stream with the standard name specified 
in section 2.23 . This stream MUST contain a PropertvSetStream packet. 


2.24.5 Non-Simple Property Set Storage 

A non-simple property set MUST be represented by an alternate stream with a name derived from 
the standard name specified in section 2.23 according to the following ABNF fRFC42341 syi 

NonSimplePropertySetAlternateStreamName = "Docf_" 

PropertySetStreamOrStorageName 


ved from 
yntax. 


This stream's contents MUST be in the format of a compound file (see rMS-CFBl rawdetails). The 
root storage of this compound file MUST conform to the non-simple property set storage format as 
specified in section 2.22 . 


2.25 Well-Known Property Set Formats 

The following sections specify the well-known property set f( 

PropertvBaq . 

2.25.1 Summarylnformation 

The Summarylnformation property set format, identified by FMTID_SumrnlryInformation 
({F29F85E0-4FF9-1068-AB91-08002B27B3D9}), Represents generic properties of a document. The 
properties specific to the Summarylnformation property set are specified in the following table. 
Except where otherwise stated, a Summarylnformation property set SHOULD have all of these 
properties, and SHOULD NOT have any other properties, except for the special properties specified 
in section 2.18 . 



Property identifier 

Type 

Meaning 

PIDSI TITLE 
(0x00000002) 

VT LPSTR 
(OxOOlE) 

The title of the document. 

PIDSI_SUBJECT 

(0x00000003) 

VT_LPSTR 

(OxOOlE) 

The subject of the document. 

PIDSI AUTHOR 
(0x00000004) 

VT_LPSTR 

(OxOOlE) 

The author of the document. 

PIDSI KEYWORDS 
(0x00000005) 

VT LPSTR 
(OxOOlE) 

Keywords related to the document. 

PIDSI COMMENTS 
(0x00000006) 

VT LPSTR 
(OxOOlE) 

Comments related the document. 

PI DSI_TEM PLATE 

VT_LPSTR 

(OxOOlE) 

The application-specific template from which the 
document was created. 

PIDSI_LASTAUTHOR 

1 (0x00000008) 

VT_LPSTR 

(OxOOlE) 

The last author of the document. 

PIDSI REVNUMBER 
(0x00000009) 

VT_LPSTR 

(OxOOlE) 

An application-specific revision number for this version of 
the document. 
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Property identifier 

Type 

Meaning 

PIDSI EDITTIME 
(OxOOOOOOOA) 

VT_FILETIME 

(0x0040) 

A 64-bit unsigned integer indicating the total amount of 
time that has been spent editing the document in 100- 
nanosecond increments. MUST be encoded as a FILETIME 
by setting the dwLowDataTime field to the low 32-bits and 
the dwHighDateTime field to the high 32-bits. 

PIDSI_LASTPRINTED 

(OxOOOOOOOB) 

VT_FILETIME 

(0x0040) 

The most recent time that the document was printed. 

PIDSI CREATE DTM 
(OxOOOOOOOC) 

VT_FILETIME 

(0x0040) 

The time that the document was created. 

PIDSI LASTSAVE DTM 
(OxOOOOOOOD) 

VT_FILETIME 

(0x0040) 

The most recent time that the document was saved. 

PIDSI PAGECOUNT 
(OxOOOOOOOE) 

VT 14 
(0x0003) 

The total number of pages in the document. 

PIDSI_WORDCOUNT 

(OxOOOOOOOF) 

VT_I4 

(0x0003) 

The total number of words in the document. 

PIDSI CHARCOUNT 
(0x00000010) 

VT_I4 

(0x0003) 

The total number of characters in the document. 

PIDSI THUMBNAIL 
(0x00000011) 

VT_CF 

(0x0047) 

Application-specific clipboard data containing a thumbnail 
representing the document's co^snts. MAY be absent. 

PIDSI APPNAME 
(0x00000012) 

VT LPSTR 
(OxOOlE) 

The name of the application that was used to create the 
document. 

PIDSI_DOC_SECURITY 

(0x00000013) 

VT_I4 

(0x0003) 

A 32-bit signed integer representing a set of application- 
suggested access control flags with the following values: 
0x00000001: Password protected 

0x00000002: Read-only recommended 

0x00000004: Read-only enforced 

0x00000008: Locked for annotations 


2.25.2 PropertyBag 

The PropertyBag property set format, identified by FMTID_PropertyBag ({20001801-5DE6-11D1- 
8E38-00C04FB9386D}), is used in applications that persist an object as a property set, typically by 
saving state variables as properties. A PropertyBag property set's associated CLSID SFIOULD identify 
the application or component whose object is persisted in the property set. The properties contained 
in a PropertyBag property set are application-specific. 


9 


:ation or componer 
irtyBag property s< 

ft 9 
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3 Structure Examples 

3.1 Summarylnformation Property Set 


The following table shows the binary contents of a stream representing a Summarylnformation 
Property Set. This is a simple property set, as the Summarylnformation format does not require 
support for stream and storage type properties. The name of this stream is 
"\005SummaryInformation", as specified in section 2.23 . 
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Stream contents 

17x 00 6E 



3C DC 73 


The stream contains a PropertvSetStream packet, with the following field values. Field offsets in this 
example are calculated from the beginning of the PropertySetStream packet. 

ByteOrder (2 bytes at offset 0): OxFFFE, as required. 

Version (2 bytes at offset 2): 0x0000, indicating that this is a version 0 property set. 

Systemldentifier (4 bytes at offset 4): 0x00020006, which is the implementation-specific 
identifier written by Windows Vista® operating system. 

CLSID (16 bytes at offset 8): GUID_NULL ({00000000-0000-0000-0000-000000000000}), 
the default value which indicates that the application that wrote the property set did not set 
the property set's CLSID. 

NumPropertySets (4 bytes at offset 24): 0x00000001, which indicates that there is only one 
property set in this stream (as required, since this is not the special case of 
FMTID_DocSummaryInformation/FMTID_UserDefinedProperties). 

FMTID 0 (16 bytes at offset 28): FMTID„SummaryInformation ({F29F85E0-4FF9-1068-AB91- 
08002B27B3D9}). 

Offset 0 (4 bytes at offset 44): 0x00000030, the offset from the beginning of this structure to 
the beginning of the field PropertySet 0. 

FMTID 1 (0 bytes): Absent, as required for a PropertySetStream with only one property set. 

Offset 1 (0 bytes): Absent, as required for a PropertySetStream with only one property set. 

PropertySet 0 (396 bytes at offset 48): A PropertySet packet (consists of the remainder of 
the streaimcontents). 

The field PropertySet 0 has the following subfield values: 

Size (4 bytes at offset 48): 0x0000018C. 

NumProperties (4 bytes at offset 52): 0x00000012 (decimal 18). 

pertyldentifierAndOffset 0-17 (144 bytes total at offset 56): This field includes 
following sequence of 18 PropertvIdentifierAndOffset packets. 



Propertyldentifier 

Offset 

0x00000001 (property identifier for the CodePaae property! 

0x00000098 

PIDSI_TITLE (0x00000002) 

OxOOOOOOAO 
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Propertyldentifier 

Offset 

PIDSI_SUBJECT (0x00000003) 

0X000000B8 

PIDSI_AUTHOR (0x00000004) 

0x00000004 

PIDSI_KEYWORDS (0x00000005) 

OxOOOOOODO 

PI DSI_CO M M E NTS (0x00000006) 

OxOOOOOODC 

PI DSI_TEM PLATE (0x00000007) 

0X000000E8 

PIDSI_LASTAUTHOR (0x00000008) 

0x000000 FC 

PIDSI_REVNUMBER (0x00000009) 

0x00000110 

PIDSI_APPNAME (0x00000012) 

OxOOOOOllC 

PIDSI_EDITTIME (0X0000000A) 

Oxooc^yc 

PIDSI_LASTPRINTED (0X0000000B) 

0x00000148 

PIDSI_CREATE_DTM (0x0000000c) 

0x00000154 

PI DSI_LASTSAVE_DTM (OxOOOOOOOD) 

0x00000160 

PIDSI_PAGECOUNT (OxOOOOOOOE) 

0X0000016C 

PIDSI_WORDCOUNT (OxOOOOOOOF) 

0x00000174 

PIDSI_CHARCOUNT (0x00000010) 

0X0000017C 

PI DSI_DOC_S ECU RITY (0x00000013) 

0x00000184 


Property 0-17 (252 bytes total at offset 200): A sequence of 18 TypedPropertvValue 
packets, as specified in the M^^|ActionP( 3. 1.1 through 3.1.18) . 

PropertySet 1: Absent, as required for a PropertySetStream with only one property set. 

3.1.1 CodePage 


CodePage property (OxOOOOOOOl)Offset: 0x00000030 + 0x00000098 : 
200) 

= 0x000000C8 (decimal 



xO xl 

x2 

- 

x4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

xC 

xD 

xE 

xF 

OOx 


LOO 

00 

E4 

04 

00 

00 











bytes at offset 200): VT_I2 (0x00000002). 

(2 bytes at offset 202): Set to zero, as required. 

at offset 204): The 16-bit signed integer 0x04E4 (decimal 1252). Indicates 
CodePaoeStrinq packets in this property set are encoded with code page 1252 (Latin 1). 
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3.1.2 PIDSI_TITLE 


CodePage property (0x00000002) Offset: 0x00000030 + OxOOOOOOAO = OxOOOOOODO (decimal 

208) 

1 


xO 

xl 

x2 

x3 

x4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

xC 

xD 

xE 

XF 

OOx 

IE 

00 

00 

00 

OF 

00 

00 

00 

4A 

6F 

65 

27 

73 

20 

64 

n 

1 

Olx 

63 

75 

6D 

65 

6E 

74 

00 

00 









r- 


Type (2 bytes at offset 208): VT_LPSTR (OxOOlE). 

Padding (2 bytes at offset 210): Set to zero, as required. 

Value: A CodePaqeStrinq packet with the following subfields: 

Size (4 bytes at offset 212): OxOOOOlF (decimal 15). 

Characters (16 bytes at offset 216): The null-terminated sequence of ■fc^h^Facters, 
"Joe's document", padded to a total length of 16 bytes. 

3.1.3 PIDSI_SUBJECT 


PIDSI_SUBJECT (0x00000003) Offset: 0x00000030 + 0x000000B8 = OxOOOC 

)00E8 (decimal 232) 


xO 

xl 

x2 

x3 

x4 

x5 

x6 

xZ 

x8 

x9 

xA 


xC 

xD 

xE 

xF 

OOx 

IE 

00 

00 

00 

04 

00 

00 . 

00 

4A 

6F 

b 

00 






Type (2 bytes at offset 232): VT_LPSTR (OxOOlE). 

Padding (2 bytes at offset 234): Set to zero, as required. 

Value: A CodePaaeStrino racket with the following subfields: 

Size (4 bytes at offset 236): 0x000004. 

Characters (4 bytes at offset 240): The null-terminated sequence of 8-bit characters, 
"Job". 


3.1.4 PIDSI_AUTHOR 


PIDSI_AUTHOR (0x00000004) Offset: 0x00000030 + 0x000000C4 = 0x000000F4 (decimal 244) 


xO 

xl 

x2 


x4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

xC 

xD 

xE 

xF 

OOx 

IE 

00 

00 

00 

04 

00 

00 

00 

4A 

J 

6F 

0 

65 

e 

00 

73 

20 

64 

6F 


9 


Type (2 b 
Padding ( 


bytes at offset 244): VT_LPSTR (OxOOlE). 
ng (2 bytes at offset 246): Set to zero, as required. 
Value: A CodePaqeStrinq packet with the following subfields: 
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Size (4 bytes at offset 248): 0x000004. 


Characters (4 bytes at offset 252): The null-terminated sequence of 8-bit characters, 
"Joe". 


3.1.5 PIDSI_KEYWORDS 


PIDSI KEYWORDS (0x00000005) Offset: 0x00000030 + OxOOOOOODO 
256) 

= OxOOOOOlOO (decimal 


xO 

xl 

x2 

x3 

x4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

xC 

xD xE 

xF 

OOx 

IE 

00 

00 

00 

04 

00 

00 

00 

4A 

6F 

65 

27 

73 


6F 


Type (2 bytes at offset 256): VT_LPSTR (OxOOlE). 

Padding (2 bytes at offset 258): Set to zero, as required. 
Value: A CodePaqeStrinq packet with the following subfields: 
Size (4 bytes at offset 260): 0x000004. 

Characters (4 bytes at offset 264): A null-terminated ^ 
string itself consists entirely of null character^ 

3.1.6 PIDSI_COMMENTS 


PIDSI COMMENTS (0x00000006) Offset: 0x00000030 + OxOOOOOODC = OxOOOOOlOC (decimal 

268) 


xO 

xl 

x2 

x3 

x4 

x5 

xM 

x7 

x8 

lfc.9 

xA 

xB 

xC 

xD 

xE 

xF 

OOx 

IE 

00 

00 

00 

04 


00 

®D0^ 

00 


00 

00 

00 

00 

00 

00 


Type (2 bytes at offset 268): VT_LPSTR (OxOOlE). 
Padding (2 bytes at offset 270): Set to zero, as required. 
Value: A CodePaqeStrinq packet with the following subfields: 
Size (4 bytes at offset 272): 0x000004 
:es at 


st 276): A null-terminated sequence of 8-bit characters. The 
r te\y of null characters. 



PIDSI_TEMPLATI 

(0x00000007) Offset: 0x00000030 + 0x000000E8 = 0x00000118 (decimal 280) 


iE 

^xl 

0^ 

▼ 

x3 

x4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

xC 

xD 

xE 

xF 

00 

00 

OC 

00 

00 

00 

4E 

6F 

72 

6D 

61 

6C 

2E 

64 









N 

0 

r 

m 

a 

1 


d 


Olx 

6F 

74 

6D 

00 
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PIDSI_TEMPLATE (0x00000007) Offset: 0x00000030 + 0x000000E8 = 0x00000118 (decimal 280) 


Type (2 bytes at offset 208): VT_LPSTR (OxOOlE). 

Padding (2 bytes at offset 282): Set to zero, as required. 
Value: A CodePaqeStrinq packet with the following subfields: 

Size (4 bytes at offset 284): OxOOOOlC (decimal 12). 

Characters (12 bytes at offset 288): The null-terminated 
"Normal, dotm". 

3.1.8 PIDSI_LASTAUTHOR 


PIDSI LASTAUTHOR (0x00000008)0ffset: 0x00000030 + OxOOOOOOAO = OxOOOOOODO (decimal 
300) 


xO 

xl 

x2 

x3 

x4 

x5 

x6 

x7 

x8 

x9 < 

XA 

vR 

U# 

xD 

xE 

xF 

OOx 

IE 

00 

00 

00 

OA 

00 

00 

00 

43 

6F 

72 

6E 

65 

6C 

69 

75 











0 

r 

2 

e 

1 

i 

u 

Olx 

73 

00 

00 

00 














s 

















Type (2 bytes at offset 300): VT_LPSTR (OxOOlE). 

Padding (2 bytes at offset 302): Set to zero, as required. 

Value: A CodePaqeStrinq packet with the following subfields: 

Size (4 bytes at offset 304): OxOOOOOA (decimal 10). 

Characters (12 bytes at offset 308): The null-terminated sequence of 8-bit characters, 
"Cornelius", padded to a total length of 12 bytes. 


4 , 

equence of 8-bit characters, 


3.1.9 PIDSI_REVN UMBER 


PIDSI REVNUMBER (0x00000009) Offset: 0x00000030 + 0x00000110 
320) 

= 0x00000140 (decima 

il 

xO 

xl 

x2 

2# 

x4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

xC 

xD 

xE 

xF 


00 ' 

00 

^00 

04 

00 

00 

00 

36 

36 

00 

00 





L_L 








4 

6 








Type (2 bytes at offset 320): VT_LPSTR (OxOOlE). 
Padding (2 bytes at offset 322): Set to zero, as required. 
Value: A CodePaqeStrinq packet with the following subfields: 
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Size (4 bytes at offset 324): 0x000004. 


Characters (4 bytes at offset 328): The null-terminated sequence of 8-bit characters, 
"46", followed by an additional null character. 

3.1.10 PIDSI_APPNAME 


PIDSI_APPNAME (0x00000012) Offset: 0x00000030 + OxOOOOOllC = 0x0000014C (decimal 332) 


xO 

xl 

x2 

x3 

x4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

xC 

xD 

*63; 

XF 

OOx 

IE 

00 

00 

00 

18 

00 

00 

00 

4D 

69 

63 

72 

6F 

73 

C- 

66 










M 

i 

c 

r 

0 

■ 

1 

f 

Olx 

74 

20 

4F 

66 

66 

69 

63 

65 

20 

57 

6F 

72 

64 

s 

00 

00 


t 


O 

f 

f 

i 

c 

e 


W 

0 


d 


L 




Type (2 bytes at offset 332) : VT_LPSTR (OxOOlE). 

Padding (2 bytes at offset 334): Set to zero, as required. 

Value: A CodePaqeStrinq packet with the following subfields: 

Size (4 bytes at offset 336): 0x000004. 

Characters (24 bytes at offset 340): The null-terminated sequence of 8-bit characters, 
"Microsoft Office Word", followed by two additional null characters. 

3.1.11 PIDSI_EDITTIME 


PIDSI_EDITTIME (OxOOOOOOOA) Offset: 0x00000030 + 0x0000013C = 0x0000016C (decimal 364) 


xO 

xl 

x2 

x3 

x4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

xC 

xD 

xE 

xF 

OOx 

40 

00 

00 

00 

00 

6E 


A2 

42 

00 

00 

000 






Type (2 bytes at offset 364): VT_FILETIME (0x0040). 

Padding (2 bytes at offset 366): Set to zero, as required. 

Value (8 bytes at offset 368): A F TIME packet that, when interpreted as a 64-bit 
unsigned integer, as is appropriate for the PIDSI_EDITTIME property, has the value 
0x00000042A2D96E00 (decimal 286,200,000,000). This value is in 100-nanosecond 
increments and is equal to 7 hours, 57 minutes. 


»IDSI_ 


STPRINTED 


PIDSI LAS 
376) 

rPRINTED (OxOOOOOOOB) Offset: 0x00000030 + 0x00000148 = 0x00000178 (decimal 

x° 

xl 

x2 

x3 

x4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

xC 

xD 

xE 

xF 

OOx 40 

00 

00 

00 

00 

16 

DO 

A1 

4E 

8E 

C6 

01 






Type (2 bytes at offset 376): VT_FILETIME (0x0040). 
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Padding (2 bytes at offset 378): Set to zero, as required. 

Value (8 bytes at offset 380): A FILETIME packet with the value June 12, 2006 6:33 P.M. 
coordinated universal time (UTC). 


3.1.13 PIDSI_CREATE_DTM 


PIDSI CREATE DTM (OxOOOOOOOC) Offset: 0x00000030 + 0x00000154 = 0x00000184 (decimal 
388) 


xO 

xl 

x2 

x3 

x4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

xC 

xD 

xE 

x^ 

OOx 

40 

00 

00 

00 

00 

1C 

F2 

D5 

2A 

CE 

C6 

01 






Type (2 bytes at offset 388): VT_FILETIME (0x0040). 

Padding (2 bytes at offset 390): Set to zero, as required. 

Value (8 bytes at offset 380): A FILETIME packet with the value September 2, 2006 12:58 
A.M. UTC. 


3.1.14 PIDSI_LASTSAVE_DTM 


PIDSI_LASTSAVE_DTM(0x0000000D) Offset: 0x00000030 + 0x00000160 = 0x00000190 (decimal 


xO 

xl 

x2 

x3 

x4 

x5 

x6 


x8 

xl 

xA 

xB 

xC 

xD 

xE 

xF 

OOx 

40 

00 

00 

00 

00 

3C 

DC 

73 

DD 

80 


01 






Type (2 bytes at offset 400): VT_FILETIME (0x0040). 

Padding (2 bytes at offset 402): Set to zero, as required. 

Value (8 bytes at offset 404): A FILETIME packet with the value March 8, 2008 5:30 A.M. 
UTC. 

3.1.15 PIDSI_PAGECOUNT 
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3.1.16 PIDSI_WORDCOUNT 


PIDSI WORDCOUNT (OxOOOOOOOF) Offset: 0x00000030 + 0x00000174 = 0x000001A4 (decimal 
420) 


xO 

xl 

x2 

x3 

x4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

xC 

xD 

xE 

xF 

OOx 

03 

00 

00 

00 

E5 

0D 

00 

00 










Type (2 bytes at offset 420): VT_I4 (0x0003). 

Padding (2 bytes at offset 422): Set to zero, as required. 

Value (4 bytes at offset 424): The 32-bit signed integer 0x00000DE5 (decimal 3,557). 

3.1.17 PIDSI_CHARCOUNT 


PIDSI CHARCOUNT (0x00000010) Offset: 0x00000030 + 0x0000017C = OxOOOOOlAC (decimal 

428) 


xO 

xl 

x2 

x3 

x4 

x5 

x6 

x7 

x8 

x9 < 

xA 

xB 

LxO^ 

xD 

^xE 

xF 

OOx 

03 

00 

00 

00 

38 

4F 

00 

00 










Type (2 bytes at offset 428): VT_I4 (0x0003). 

Padding (2 bytes at offset 430): Set to zerqf as required. 

Value (4 bytes at offset 432): The 32-bit signed integer 0x00004F38 (decimal 20,280). 

3.1.18 PIDSI_DOC_SECURITY 


PI DSI_DOC_SECU RITY (0x00000013) Ofl 

Fset: 0x00000030 + 0x00000184 = 0x000001B4 (decimal 


xO 

xl 

x2 

x3 

^4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

xC 

xD 

xE 

xF 

OOx 

03 

00 

00 

00 

% 

00 

00^ 

00 










Type (2 bytes at offset 436): VT_I4 (0x0003). 

Padding (2 bytes at offset 438): Set to zero, as required. 

Value (4 bytes at offset 440): The 32-bit signed integer 0x00000000, indicating that no 
accdfS controtis suggested by the application used to create the document. 

Property Set 

strates the usage of some of the capabilities of OLEPS that are not used in 
property sets (as specified in section 3.1 ). The example is a PropertvBaq 
an application has used to persist object state in an application-specific manner, 
property set uses the non-simple property set format and is stored using the Alternate 
nq . 

e with which the property set is associated has two alternate streams: "{4c8ccl55-6cle- 
Idl-8e41-00c04fb9386d>" and "Docf_\005Bagaaqy23kudbhchAaq5u2chNd". 
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3.2.1 Control Stream ("{4c8ccl55-6cle-lldl-8e41-00c04fb9386d}") 


The following table shows the binary contents of the control stream, which is required for a file 
containing one or more property sets stored using the alternate stream binding . This stream is 
identified by its name, "{4c8ccl55-6cle-lldl-8e41-00c04fb9386d}", as specified in section 2.24.3 . 


Stream contents 


xO xl x2 x3 x4 x5 x6 x7 x8 x9 xA xB xC xD 



Reservedl (2 bytes at offset 0): Set to zero, as required. 

Reserved2 (2 bytes at offset 2): Set to zero, as required. 

ApplicationState (4 bytes at offset 4): Set to zero, indicating that the application did not 
provide a value. 

CLSID (0 bytes): Absent, indicating that the application did not provide a value. 

3.2.2 PropertyBag Stream ("Docf_\005Bagaaqy23kudbhchAaq5u2chNd") 

This stream contains the non-simple property set storage format representing thte PropertyBag 
property set (as specified in section 3.2) . The FMTID of the property set, FMTID_PropertyBag 
({2000180 1-5DE6-11D1-8E38-00C04FB9386D}), as well as the fact that it is a non-simple property 
set, are indicated by its name, "Docf_\005Bagaaqy23kudbhchAaq5u2chNd", as specified in section 
2.24.5 . 

The stream's contents are in the format of a compound file (see I~MS-CFB1 for details). For brevity, 
the binary contents of this stream are omitted here. The compound file stored in this alternate 
stream represents a storage with the following elements: 

■ A stream named "CONTENTS" 

■ A stream named "prop6" 

■ A storage named "propl2" 

The associated CLSID of the root storaggis {994BFF53-DDF9-42AD-A56A-FFEA3617AC16}, which, 
as specified in section 2.22 . is the associated CLSID of the property set. This value was set by the 
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The stream contains a PropertvSetStream packet, with the following field values: 



Note Field offsets in this example are calculated from the beginning of the PropertySetStream 
packet. 

ByteOrder (2 bytes at offset 0): OxFFFE, as required. 

Version (2 bytes at offset 2): 0x0001, indicating that this is a version 1 property set. This 
value was set by the OLEPS implementation, because the application used the following 
features not supported by version 0 property sets: 

■ A property of type VT_ARRAY | VT_I1 (0x2010). 

■ The Behavior property . 

Systemldentifier (4 bytes at offset 4): 0x00020006, which is the operating system 
identifier. <10> 

CLSID (16 bytes at offset 8): {994BFF53-DDF9-42AD-A56A-FFEA3617AC16}. This is the same 
value as the associated CLSID of the storage in which this property set is stored. 

NumPropertySets (4 bytes at offset 24): 0x00000001, which indicates that there is only one 
property set in this stream (as required, because this is not the special case of 
FMTID_DocSummaryInformation/FMTID_UserDefinedProperties). 

FMTID 0 (16 bytes at offset 28): FMTID_PropertyBag ({20001801-5DE6-11D1-8E38- 
00C04FB9386D}). 

Offset 0 (4 bytes at offset 44): 0x00000030, the offset from the beginning of this structure to 
the beginning of the field PropertySet 0. 

FMTID 1 (O bytes): Absent, as required for a PropertySetStream with only one property set. 
Offset 1 (0 bytes): Absent, as required for a PropertySetStream with only one property set. 

PropertySet 0 (396 bytes at offset 48): A PropertySet packet (consists of the remainder of 
the stream contents). 

The field PropertySet 0 has the following subfield values: 

Size (4 bytes at offset 48): OxOOOOOlDC (decimal 496). 

NumProperties (4 bytes at offset 52): 0x0000000a (decimal 10). 
PropertyldentifierAndOffset 0-9 (80 bytes total at offset 56): This consists of the 


following sequence of PropertyldentifierAndOffset packets. 

Propertyldentifier 

Offset 

0x00000001 (property identifier for the CodePaae property') 

0x00000058 

0x80000000 (property identifier for the Locale property') 

0x00000060 

0x80000001 (property identifier for the Behavior property) 

0x00000068 

0x00000000 (eroDertv identifier for the Dictionary property) 

0x00000070 

0x00000004 

0x00000138 


[MS-OLEPS] - V20111214 

Object Unking and Embedding (OLE) Property Set Data Structures 


Copyright © 2011 Microsoft Corporation. 
Release: Wednesday, December 14, 2011 


Propertyldentifier 



packets, except the Dictionary property, which is a Dictionary packet, as specified in 
sections 3. 2. 2. 1.1 through 3.1.18 . 


3. 2. 2.1.1 CodePage 


CodePage property (0x00000001) Offset: 0x00000030 + 0x00000058 = 0x000000 

136) k A 

188 (decimal 


xO 

xl 

x2 

x3 

x4 

x5 

x6 

x7 

x8 

x9 ^ 

xA 

xB 

Vwt' 

xD 

xE 

xF 

00x 

02 

00 

00 

00 

BO 

04 

00 

00 










Type (2 bytes at offset 136): VT_I2 (0x0002). 

Padding (2 bytes at offset 138): Set to zero, as required. 

Value (4 bytes at offset 140): The 2-byte signed integer 0x04B0 (decimal 1200). This value is 
CP_WINUNICODE, which indicates that CodePageStrinq packets in this property set are 
encoded as arrays of 16-bit Unicode characters. 


3. 2. 2.1. 2 Locale 


Locale property (0x80000000) Offset: 0x00000030 + 0x00000060 = 0x00000090 (decimal 144) 


xO 

xl 

x2 

x3 

x4 

x5 

x6^ 

x7 

x8 

x9 

xA 

xB 

xC 

xD 

xE 

xF 

OOx 

13 

00 

00 

00 

00 

00 

. 09 

08 










Type (2 bytes at offset 144): VTJJI4 (0x0013). 

Padding (2 bytes at offset 146): Set to zero, as required. 

Value (4 bytes at offset 148): The 4-byte unsigned integer 0x08090000. This value encodes 
-ithe Language ID 0x0809 (en-GB) and Sort ID 0x0 (SORT_DEFAULT), as specified in fMS- 
LCID1 section 2.2. 

3. 2. 2. 1.3 Behavior 



Behavior property (0x80000001) Offset: 0x00000030 + 0x00000068 = 0x00000098 (decimal 
152) 


xO xl x2 x3 x4 x5 x6 x7 x8 x9 xA xB xC xD xE xF 
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Behavior property (0x80000001) Offset: 0x00000030 + 0x00000068 = 0x00000098 (decimal 
152) 


Type (2 bytes at offset 152): VTJJI4 (0x0013). 

Padding (2 bytes at offset 154): Set to zero, as required. 

Value (4 bytes at offset 156): The 4-byte unsigned integer 0x00000001, indicating 
property names are case-sensitive. 


3. 2. 2. 1.4 Dictionary 


Dictionary property (0x00000000) Offset: 0x00000030 + 0x00000070 = 0x00001 
160) 


I00A0 (decimal 



xO 

xl 

x2 

x3 

x4 

x5 

x6 

x7 

x8 

x9 

xA 

- 

s 

:^ D 


xF 

OOx 

06 

00 

00 

00 

04 

00 

00 

00 

0E 

00 

00 

00 

44 

G ’ Q ^ 

» 

00 

Olx 

73 

00 

70 

00 

6C 

00 

61 

00 

79 

00 

,3 

00 

6F 

00 

6C 

00 

02x 

6F 

00 

75 

00 

72 

00 

00 

00 

06^ 

°5a 

00 

00 

09 

00 

00 

00 

03x 

4D 

00 

79 

00 

53 

00 

74 

00 

72 

00 

65 

00 

►si 

00 

6D 

00 

04x 

00 

00 

00 

00 

07 

00 

00 

00 

0B 

00 


00 

50 

00 

72 

00 

05x 

69 

00 

63 

00 

65 

00 

28 

00 


00 


00 

50 

00 

29 

00 

06x 

00 

00 

00 

00 

OC 

00 

00 

00 

09 

00 

00 

00 

4D 

00 

79 

00 

07x 

53 

00 

74 

00 

6F 

00 

hJ2 

00 


00 

67 

00 

65 

00 

00 

00 

08x 

27 

00 

00 

00 

0E 

00 

00 

00 

43 

00 

61 

00 

73 

00 

65 

00 

09x 

53 

00 

65 

00 ^ 


00 


00 

69 

00 

74 

00 

69 

00 

76 

00 

OAx 

65 

00 

00 

00 

9^ 

k)0 

00 

00 

0E 

00 

00 

00 

43 

00 

41 

00 

OBx 

53 

00 

v 4Sk 

00 

53 

00 

45 

00 

4E 

00 

53 

00 

49 

00 

54 

00 

OCX 

49 

J# 

56^ 

00 

45 

So 

00 

00 










NumEntries (4 bytes at offset 160): 0x00000006. 

Entry 0-5 (196 bytes total at offset 164): This consists of the following sequence of six 
DictionarvEntrv packets. 






xT 

xl 

x2 

x3 

x4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

xC 

xD 

xE 

xF 


04 

00 

00 

00 

0E 

00 

00 

00 

44 

00 

69 

00 

73 

00 

70 

00 










D 

I 

s 

P 
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Entry 0 

Olx 

6C 00 

61 00 

79 00 

33 00 

6F 00 

6C 00 

6F 00 

75 00 


1 

a 

y 

c 

O 

1 

0 

u 

02x 

72 00 

00 00 














r 















Propertyldentifier (4 bytes at offset 164): 0x00000004. 

Length (4 bytes at offset 168): OxOOOOOOOE (decimal 14). 

Name (28 bytes at offset 172): The null-terminated sequence of 16-bit Unicode 
characters, "DisplayColour". 


1 Entry 1 [ 


xO 

xl 

x2 

x3 

x4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

xC 


y XE 

xF 

OOx 

06 

00 

00 

00 

09 

00 

00 

00 

4D 

00 

^79 

00 

53 

00 

74 

00 










M 

y 

S 

ozn 

Olx 

72 

00 

65 

00 

61 

00 

6D 

00 

00 

... 0(P 

00 

00 







6 

a 

| m 










Propertyldentifier (4 bytes at offset 200): 0x00000006. 

Length (4 bytes at offset 204): 0x00000009. 

Name (20 bytes at offset 208): The null-terminated sequence of 16-bit Unicode 
characters, "MyStream", padded with zeroes to a multiple of 4 bytes. 


Entry 2 


xO 

xl 

x2 

x3^ 

x4 

x5 

^6 

x7 

x8 

x9 

xA 

xB 

xC 

xD 

xE 

xF 

OOx 

07 

60 

00 

00 

oiP§ 

kio 

00 

00 

50 

00 

72 

00 

69 

00 

63 

00 


> 


V 


/ 




P 

r 

I 

C 

Olx- 

65 

0(^ 

28 

00 

47 

00 

42 

00 

50 00 

29 00 

00 00 

00 

00 


« 

1 

<3 

B 

P 

) 





9 


o 


Propertyldentifier (4 bytes at offset 228): 0x00000007. 

Length (4 bytes at offset 232): 0x0000000b (decimal 11). 

Name (24 bytes at offset 236): The null-terminated sequence of 16-bit Unicode 
characters, "Price(GBP)", padded with zeroes to a multiple of 4 bytes. 
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Entry 3 


xO xl 

x2 x3 

x4 x5 

x6 x7 

x8 x9 

xA xB 

xC xD 

xE xF 

OOx 

OC 00 

00 00 

09 00 

00 00 

4D 00 

79 00 

53 00 

74 00 






M 

y 

S 

* 

Olx 

6F 00 

72 00 

61 00 

67 00 

65 00 

00 00 


1 


0 

r 

a 

9 

e 



zb 


Propertyldentifier (4 bytes at offset 260): OxOOOOOOOC. 

Length (4 bytes at offset 264): OxOOOOOOOA (decimal 10). 

Name (20 bytes at offset 268): The null-terminated sequence of 16-bit Unicode 
characters, "MyStorage". 


Entry 4 







% 




xO 

xl 

x2 

x3 

x4 x5 

x6 x7 

x8 x9 

xC xD 

xE xF 

OOx 

27 

00 

00 

00 

OE 00 

00 00 

43 00 

61 00 

1 73 00 

65 00 








z 

a 

s 

e 

Olx 

53 

00 

65 

00 

6E 00 

73 !£ 

69 00 

74 00 

69 00 

76 00 


S 

e 

n 

i> 

1 

* 

I 

v 

02x 

65 

00 

00 

00 



X 





e 



\> 






Propertyldentifier (4 bytes at offset 288): 0x00000027. 

Length (4 bytes at offset 292): OxOOOOOOOE (decimal 14). 

Name (28 bytes at offset 296): The null-terminated sequence of 16-bit Unicode 
characters, "CaseSensitive". 




Entry 5 
















A 

' xO 


x2 

X3 

x4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

xC 

xD 

xE 

xF 

OOx 

92 

00 


00 

OE 

00 

00 

00 

43 

00 

41 

00 

53 

00 

45 

00 




f 






C 

A 

S 

E 


^53 

00 

45 

00 

4E 

00 

53 

00 

49 

00 

54 

00 

49 

00 

56 

00 



E 

N 

S 

I 

T 

I 

V 

02* 

45 

00 

00 

00 
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Propertyldentifier (4 bytes at offset 324): 0x00000092 (decimal 146). 

Length (4 bytes at offset 328): OxOOOOOOOE (decimal 14). 

Name (28 bytes at offset 332): The null-terminated sequence of 16-bit Unicode 
characters, "CASESENSITIVE". 

This property set assigns property names to each of its properties (except the Special properties , 
which cannot have property names). 


Propertyldentifier 

Name 

0x00000004 

DisplayColour 

0x00000006 

MyStream 

0x00000007 

Price(GBP) 

0x0000000c 

MyStorage 

0x00000027 

CaseSensitive 

0x00000092 

CASESENSITIVE 


Note that two of the properties have names that are equal when compared case-insensitively 
("CaseSensitive" and "CASESENSITIVE"). This is valid because the property set's Behavior property 
has value 0x00000001. Otherwise, this would be invalid. 


3.2.2. 1.5 DisplayColour 


DisplayColour (0x00000004) Offset: 0x00000030 + 0x00000138 = 0x00000168 (decimal 360) 


xO 

xl 

x2 

x3 

x4 


x6 

x7 

x8 


xA 

xB 

xC 

xD 

xE 

xF 

OOx 

08 

00 

00 

00 

OA 

00 

00 

OQ 

47 

00 

72 

00 

65 

00 

79 

00 










G 

r 

e 

y 

Olx 

00 

00 

00 

00 










Type (2 bytes at offset 360): VT_BSTR (0x0008). 

Padding (2 bytes at offset 362): Set to zero, as required. 

Value: Value A CodePageStrinq packet with the following subfields: 
Size (4 bytes at offset 364): OxOOOOOA (decimal 10). 



icters (12 bytes at offset 368): The null-terminated sequence of 16-bit Unicode 
iracters, "Gra 


"Gray", padded with zeroes to a multiple of 4 bytes. 


(0x00000006) Offset: 0x00000030 + 0x0000014C = 0x0000017C (decimal 380) 
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MyStream (0x00000006) Offset: 0x00000030 + 0x0000014C = 0x0000017C (decimal 380) 

OOx 

49 

00 

00 

00 

CA 

84 

95 

F9 

23 

CA 

OB 

47 

83 

94 

22 

01 

Olx 

77 

90 

7A 

AD 

OC 

00 

00 

00 

70 

00 

72 

00 

6F 

00 

70 

00 










P 

r 

0 

P 

02x 

36 

00 

00 

00 












p 


6 













□ 


Type (2 bytes at offset 380): VT_VERSIONED_STREAM (0x0049) 
Padding (2 bytes at offset 382): Set to zero, as required. 

Value: A VersionedStream packet with the following subfields: 




VersionGuid (16 bytes at offset 384): {F99584CA-CA23-470B-8394-; 

This is an application-specific value that has no meaning to OLEPS implementa 

Size (4 bytes at offset 400): OxOOOOOOOC (decimal 12). 

Characters (12 bytes at offset 404): The nulbfcqrminated sequence of 16-bit Unicode 
characters, "prop6". 

Note that the TypedPropertyValue packet representing this property does not contain the complete 
property value. The remainder of the property value is contained in the stream, " prop6 ". 

3. 2. 2. 1.7 Price(GBP) 


Price(GBP) (0x00000007) Offset: 0x00000030 + 0x00000170 = OxOOOOOlAO (decimal 416) 


xO 

xl 

x2 

x3 

x4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

xC 

xD 

xE 

xF 

OOx 

49 

00 

00 

00 

00 

50^ 

14 


00 

00 

00 

00 






Type (2 bytes at offset 416): VT_CY (0x0006). 

Padding (2 bytes at offset 418): Set to zero, as required. 

Value (8 bytes at offset 420): A URRENCY packet with the value 133.1200 (presumably 
£133.12 based on the name of the property). 


MyStorage 


ooooo 

1C) Offset: 0x00000030 + 0x0000017C = 1 

OxOOOOOl AC (decimal 428) 
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00 

00 

70 
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00 

6F 
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Type (2 bytes at offset 428): VT_STORED_OBJECT (0x0045). 
Padding (2 bytes at offset 430): Set to zero, as required. 

Value: An IndirectPropertvName packet with the following subfields: 


Size (4 bytes at offset 432): OxOOOOOOOE (decimal 14). 

Characters (16 bytes at offset 436: The null-terminated sequence of 16-bit U 
characters, "propl2", padded with zeroes to a multiple of 4 bytes. 

Note that the TvpedPropertvValue packet representing this property does not contain the 
value. The property value is contained in the storage, "propl2". 



3. 2. 2. 1.9 CaseSensitive 


CaseSensitive (0x00000027) Offset: 0x00000030 + 0x00000194 = 0x000001C4 (decimal 452) 


xO 

xl 

x2 

x3 

x4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

xC 

^xD 

xE 

xF 

OOx 

10 

20 

00 

00 

10 

00 

00 

00 

02 

00 

*00 

ool 

03 


00 

00 

Olx 

FF 

FF 

FF 

FF 

05 

00 

00 

00 

00 

00 

00 

00 

03 

F8 

14 

17 

02x 

12 

87 

45 

29 

25 

11 

33 

56 

79 

A2 , 

9C 

OQ 






Type (2 bytes at offset 452): VT_ARRAY | VT_I1 (0x2010). 

Padding (2 bytes at offset 454): Set to ?ero, as required. 

Value: An ArravHeader followed by a sequence of 1-byte signed integers, followed by zero 
padding to a total length that is a multiple of 4 bytes. The ArrayHeader has the following 
subfields: 

Type (4 bytes at offset 456): 0x00000010, the value obtained by clearing the VT_ARRAY 
(0x2000) bit of the Type field. 

NumDimensions (4 bytes at offset 460): 0x00000002. 

Dimension O-l (16 bytes total at offset 464): This includes the following sequence of 
ArravDimension packets. 
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Dimension 1 


Size (4 bytes at offset 472): 0x00000005. 

IndexOffset (4 bytes at offset 476): 0x00000000. 

Scalar values 0-14 (16 bytes total at offset 480): The total number of scale 
the array property is 3x5 = 15. 

A sequence of 15 1-byte signed integers, padded with zeroes to a multiple of 4 bytes. Their 
arrangement in the array is shown in the following table. 



Dimension 1 index 

Dimension 0 index 

0 

1 

2 


> 

-1 

0x03 

0xF8 

(decimal - 
8) 

0xl4^k 

(decim^^k 

^20) 

0x17 

(de^pl 

23) 

0x12 

(decimal 

18) 

0 

0x87 

(decimal - 
121) 

0x45 

(decimal 

69) 

0x29 

(decimal 

41) 

0x25 

(decimal 

37) 

0x11 

(decimal 

17) 

1 

0x33 

(decimal 

51) 

0x56 \ 
(decimal 

86) 

0x79 

(decimal 

\iai) 

0xA2 

(decimal - 
94) 

0x9C 

(decimal - 
100) 


3.2.2.1.10 CASESENSITIVE 


CASESENSITIVE (0x00000092) Offset: 0x00000030 + OxOOOOOlCO = OxOOOOOlFO (decimal 496) 
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9C 






Type (2 bytes at offset 496): VT_VECTOR | VT_VARIANT (OxlOOC). 

Padding (2 bytes at offset 498): Set to zero, as required. 

: A VectorHeaaer followed by a sequence of TypedPropertyValue packets. The 
irHeader has the following subfield: 

bytes at offset 500): 0x00000002. 

values 0-1 (20 bytes total at offset 504): This includes the following sequence of 
:dPropertyValue packets. 
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Value 0 


xO 

xl 

x2 

x3 

x4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

xC 

xD 

xE 

xF 

OOx 

11 

00 

00 

00 

A9 

00 

00 

00 









Type (2 bytes at offset 504): VT_UI1 (0x0011). 

Padding (2 bytes at offset 506): Set to zero, as required. 

Value (4 bytes at offset 508): The 1-byte unsigned integer 0xA9 (decimal 169), padded 
with zeroes to a multiple of 4 bytes. 

Value 1 



xO 

xl 

x2 

x3 

x4 

x5 

x6 

x7 

x8 

x9 

xA 

xB 

* 

«•= 

r 


OOx 

14 

00 

00 

00 

A9 

00 

76 

99 

3B 

22 

10 




K 



Type (2 bytes at offset 512): VT_I8 (0x0014). 

Padding (2 bytes at offset 454): Set to zero, as reqi 

Value: The 8-byte signed integer 0x9C10223B9‘ 
7201218164792360791). 


3. 2. 2. 2 "prop6" Stream 

This stream contains the stream portion of the 
( Prooertvldentifier 0x00000006). For brevil 

3. 2. 2. 3 "propl2" Storage 

This storage contains the value of the 
( Propertvldentifier 0x0000000c). 
an object. For brevity, the contents 


property, "MyStream" 
f the stream are omitted here. 


property, "MyStorage" 
contains an application-specific representation of 
e are omitted here. 
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4 Security Considerations 

None. 
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5 Appendix A: Product Behavior 


The information in this specification is applicable to the following Microsoft products or supplemental 
software. References to product versions include released service packs: 


Microsoft Windows NT® 4.0 operating system 
Microsoft Windows® 2000 operating system 
Windows® XP operating system 
Windows Server® 2003 operating system 
Windows Vista® operating system 
Windows Server® 2008 operating system 
Windows® 7 operating system 
Windows Server® 2008 R2 operating system 
Windows® 8 Beta operating system 
Windows Server® 8 Beta operating system 

Exceptions, if any, are noted below. If a service pack or Quick Fix Engineering (QFE) number 
appears with the product version, behavior changed in that service pack or QFE. The new behavior 
also applies to subsequent service packs of the product unless otherwise specified. If a product 
edition appears with the product version, behavior is different in that product edition. 

Unless otherwise specified, any statement of optional behavior in this specification that is prescribed 
using the terms SHOULD or SHOULD NOT implies product behavior in accordance with the SHOULD 
or SHOULD NOT prescription. Unless otherwise specified, the term MAY implies that the product 
does not follow the prescription. 



<1> Section 2.5: Windows presents properties with PropertvSet VT_LPSTR (OxOOlE) to applications 
as null-terminated string values such that the application cannot reliably detect the presence of 
trailing null characters or any characters following the first embedded null character. Properties with 
PropertvTvpe VT_BSTR (0x0008) are presented to the application as a value of type BSTR (for 
more information, see JMS-DTYP1 section 2.2.5), which is an explicitly-sized string type, and in 
which an application can detect these characters. Identical behavior also applies to scalar values of 
type VT_LPSTR or VT_BSTR, respectively, when these values are part of a vector or array property 
type. 

<2> Section 2.18.2: Windows enables applications creating a property set to select whether a 
property set is Unicode, in whicn case the CodePaqe property is CP_WINUNICODE (0x04B0). 
Alternatively, it can select ANSI, in which case the CodePaqe property is the current ANSI code page 
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Windows version 

Limit (bytes) 

Windows NT 

262,144 

Windows 2000 

1,048,576 

Windows XP 

1,048,576 

Windows XP SP2 

1,048,576 

Windows XP SP3 

2,097,152 

Windows Server 2003 with SP1 

1,048,576 

Windows Server 2003 SP2 

2,097,152 

Windows Vista 

2,097,152 

Windows Server 2008 

2,09^,152 

Windows 7 

2,097,152 

Windows Server 2008 R2 

^,097,15^ 

Windows 8 Beta 

2,097,152 

Windows Server 8 Beta 

L : 2';097,l52 


<5> Section 2.21: Windows NT does not support version 1 property sets. 

<6> Section 2.21: Different versions of Windows write the Systemldentifier field as follows. 
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<9> Section 2.24: The following versions of Windows support the alternate stream binding for files 
on NTFS volumes: 


Windows 2000 


Windows Server 2003 
Windows Vista 


Windows Server 2008 


Windows Server 2008 R2 

Windows 8 Beta 

Windows Server 8 Beta 

<10> Section 3. 2.2.1: 0x00020006 is the Systemldentifier written by V 
is the Systemldentifier written by Windows 7 and Windows 8 Beta. 
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6 Change Tracking 

This section identifies changes that were made to the [MS-OLEPS] protocol document between the 
September 2011 and December 2011 releases. Changes are classified as New, Major, Minor, 
Editorial, or No change. 

The revision class New means that a new document is being released. 

The revision class Major means that the technical content in the document was significantly revised. 
Major changes affect protocol interoperability or implementation. Examples of major changes are: 

■ A document revision that incorporates changes to interoperability requirements Qp^^^onality. 

■ An extensive rewrite, addition, or deletion of major portions of content. 

■ The removal of a document from the documentation set. 

■ Changes made for template compliance. 


:ent was clarified. M 



Minor 
jffchor changes are 


The revision class Minor means that the meaning of the technical content 

changes do not affect protocol interoperability or implementation. Examples of mi 
updates to clarify ambiguity at the sentence, paragraph, or table level. 

The revision class Editorial means that the language and formatting in the technical content was 
changed. Editorial changes apply to grammatical, formatting, and style issues. 

The revision class No change means that no new technical or language changes were introduced. 
The technical content of the document is identical to the last released version, but minor editorial 
and formatting changes, as well as updates tc^jne header and footer information, and to the revision 
summary, may have been made. 

Major and minor changes can be described fi n&lfeilowing change types: 

New content added. 

Content updated. 

Content removed. 

New product behaj/ior nob 
Product behavior note updated 
Product behavior note removed. 

New protocol syntax added. 

Protocol syntax updated. 

due to protocol revision. 

Content updated due to protocol revision. 

Content removed due to protocol revision. 

New protocol syntax added due to protocol revision. 




: 

' 
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■ Protocol syntax updated due to protocol revision. 

■ Protocol syntax removed due to protocol revision. 

■ New content added for template compliance. 

■ Content updated for template compliance. 

■ Content removed for template compliance. 

■ Obsolete document removed. 

Editorial changes are always classified with the change type Editorially updated. 
Some important terms used in the change type descriptions are defined as follow 

■ Protocol syntax refers to data elements (such as packets, structures, enumeratti 
methods) as well as interfaces. 

■ Protocol revision refers to changes made to a protocol that affect th^ 
the wire. 


The changes made to this document are listed in the following tal 
contact protocoKaimicrosoft.com . 


able. F 


Section 

7 ^* 

Tracking number (if applicable) 
and description 

s. 

(Y or 

N) 

Change type 

2.21 

ProDertvSetStream 

Updated product behavior notes for Windows 8 

Beta and Windows Server 8 Beta. 

Y 

Product 
behavior note 
updated. 

2.24 

Standard Bindinas 

Updated product behavior note for Windows® 8 
Beta operating system and Windows Server® 8 
Beta operating system. 

Y 

Product 
behavior note 
updated. 

3. 2. 2.1 

"CONTENTS" Stream 

^ 

Updated product beh£&||jy-iote for Windows 8 

Y 

Product 
behavior note 
updated. 

- ^ ^ 

Appendix A: Product 

Behavior 

^Added Windows 8 Beta and Windows Server 8 

Beta to applidibility list. 

Y 

Content 

updated. 


9 
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